Skip to content

Commit ad9c653

Browse files
author
mikeblome
committed
link fixes in dotnet windows and oledb
1 parent 33dc29d commit ad9c653

52 files changed

Lines changed: 123 additions & 114 deletions

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

‎docs/cppcx/clr-integration-c-cx.md‎

Lines changed: 11 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -1,21 +1,21 @@
1-
---
2-
title: "CLR integration (C++/CX) | Microsoft Docs"
3-
ms.custom: ""
4-
ms.date: "01/22/2017"
5-
ms.technology: "cpp-windows"
6-
ms.topic: "language-reference"
7-
ms.assetid: 76e213cf-2f3d-4181-b35b-9fd25d5b307c
8-
author: "mikeblome"
9-
ms.author: "mblome"
10-
ms.workload: ["cplusplus"]
1+
---
2+
title: "CLR integration (C++/CX) | Microsoft Docs"
3+
ms.custom: ""
4+
ms.date: "01/22/2017"
5+
ms.technology: "cpp-windows"
6+
ms.topic: "language-reference"
7+
ms.assetid: 76e213cf-2f3d-4181-b35b-9fd25d5b307c
8+
author: "mikeblome"
9+
ms.author: "mblome"
10+
ms.workload: ["cplusplus"]
1111
---
1212
# CLR integration (C++/CX)
1313
Some Windows Runtime types receive special handling in C++/CX and the languages that are based on the common language runtime (CLR). This article discusses how several types in one language map to another language. For example, the CLR maps Windows.Foundation.IVector to System.Collections.IList, Windows.Foundation.IMap to System.Collections.IDictionary, and so on. Similarly, C++/CX specially maps types such as Platform::Delegate and Platform::String.
1414

1515
## Mapping the Windows Runtime to C++/CX
1616
When C++/CX reads a Windows metadata (.winmd) file, the compiler automatically maps common Windows Runtime namespaces and types to C++/CX namespaces and types. For example, the numeric Windows Runtime type `UInt32` is automatically mapped to `default::uint32`.
1717

18-
C++/CX maps several other Windows Runtime types to the **Platform** namespace. For example, the **Windows::Foundation** HSTRING handle, which represents a read-only Unicode text string, is mapped to the C++/CX `Platform::String` class. When a Windows Runtime operation returns an error HRESULT, it's mapped to a C++/CX `Platform::Exception`. For more information, see [Built-in Types](https://msdn.microsoft.com/acc196fd-09da-4882-b554-6c94685ec75f).
18+
C++/CX maps several other Windows Runtime types to the **Platform** namespace. For example, the **Windows::Foundation** HSTRING handle, which represents a read-only Unicode text string, is mapped to the C++/CX `Platform::String` class. When a Windows Runtime operation returns an error HRESULT, it's mapped to a C++/CX `Platform::Exception`.
1919

2020
The C++/CX also maps certain types in Windows Runtime namespaces to enhance the functionality of the type. For these types, C++/CX provides helper constructors and methods that are specific to C++ and are not available in the type's standard .winmd file.
2121

‎docs/cppcx/collections-c-cx.md‎

Lines changed: 10 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -1,13 +1,13 @@
1-
---
2-
title: "Collections (C++/CX) | Microsoft Docs"
3-
ms.custom: ""
4-
ms.date: "01/22/2017"
5-
ms.technology: "cpp-windows"
6-
ms.topic: "language-reference"
7-
ms.assetid: 914da30b-aac5-4cd7-9da3-a5ac08cdd72c
8-
author: "mikeblome"
9-
ms.author: "mblome"
10-
ms.workload: ["cplusplus"]
1+
---
2+
title: "Collections (C++/CX) | Microsoft Docs"
3+
ms.custom: ""
4+
ms.date: "01/22/2017"
5+
ms.technology: "cpp-windows"
6+
ms.topic: "language-reference"
7+
ms.assetid: 914da30b-aac5-4cd7-9da3-a5ac08cdd72c
8+
author: "mikeblome"
9+
ms.author: "mblome"
10+
ms.workload: ["cplusplus"]
1111
---
1212
# Collections (C++/CX)
1313
In a C++/CX program, you can make free use of Standard Template Library (STL) containers, or any other user-defined collection type. However, when you pass collections back and forth across the Windows Runtime application binary interface (ABI)—for example, to a XAML control or to a JavaScript client—you must use Windows Runtime collection types.
@@ -138,6 +138,5 @@ void FindButton(UIElementCollection^ col)
138138

139139
## See Also
140140
[Type System](../cppcx/type-system-c-cx.md)
141-
[Built-in Types](https://msdn.microsoft.com/acc196fd-09da-4882-b554-6c94685ec75f)
142141
[Visual C++ Language Reference](../cppcx/visual-c-language-reference-c-cx.md)
143142
[Namespaces Reference](../cppcx/namespaces-reference-c-cx.md)

‎docs/cppcx/platform-collections-unorderedmapview-class.md‎

Lines changed: 12 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -1,14 +1,14 @@
1-
---
2-
title: "Platform::Collections::UnorderedMapView Class | Microsoft Docs"
3-
ms.custom: ""
4-
ms.date: "12/30/2016"
5-
ms.technology: "cpp-windows"
6-
ms.topic: "reference"
7-
f1_keywords: ["collection/Platform::Collections::UnorderedMapView"]
8-
ms.assetid: 545a3725-2efd-4cc1-b590-4a7cd2351f61
9-
author: "mikeblome"
10-
ms.author: "mblome"
11-
ms.workload: ["cplusplus"]
1+
---
2+
title: "Platform::Collections::UnorderedMapView Class | Microsoft Docs"
3+
ms.custom: ""
4+
ms.date: "12/30/2016"
5+
ms.technology: "cpp-windows"
6+
ms.topic: "reference"
7+
f1_keywords: ["collection/Platform::Collections::UnorderedMapView"]
8+
ms.assetid: 545a3725-2efd-4cc1-b590-4a7cd2351f61
9+
author: "mikeblome"
10+
ms.author: "mblome"
11+
ms.workload: ["cplusplus"]
1212
---
1313
# Platform::Collections::UnorderedMapView Class
1414
Represents a read-only view into a *map*, which is a collection of key-value pairs.
@@ -213,7 +213,7 @@ UnorderedMapView(
213213
The typename of the UnorderedMapView.
214214

215215
`H`
216-
A function object that can a hash value for a key. Defaults to [std::hash\<K>](https://msdn.microsoft.com/54f67435-af9d-4217-a29d-fa4d2491a104) for the types that `std::hash` supports.
216+
A function object that can a hash value for a key. Defaults to [std::hash\<K>](../standard-library/hash-class.md) for the types that `std::hash` supports.
217217

218218
`P`
219219
A type that provides a function object that can compare two keys to determine their equality. Defaults to [std::equal_to\<K>](../standard-library/equal-to-struct.md).

‎docs/cppcx/strings-c-cx.md‎

Lines changed: 10 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -1,13 +1,13 @@
1-
---
2-
title: "Strings (C++/CX) | Microsoft Docs"
3-
ms.custom: ""
4-
ms.date: "01/22/2017"
5-
ms.technology: "cpp-windows"
6-
ms.topic: "language-reference"
7-
ms.assetid: 5b34e1df-7c2b-4269-aba8-b767d36c49d9
8-
author: "mikeblome"
9-
ms.author: "mblome"
10-
ms.workload: ["cplusplus"]
1+
---
2+
title: "Strings (C++/CX) | Microsoft Docs"
3+
ms.custom: ""
4+
ms.date: "01/22/2017"
5+
ms.technology: "cpp-windows"
6+
ms.topic: "language-reference"
7+
ms.assetid: 5b34e1df-7c2b-4269-aba8-b767d36c49d9
8+
author: "mikeblome"
9+
ms.author: "mblome"
10+
ms.workload: ["cplusplus"]
1111
---
1212
# Strings (C++/CX)
1313
Text in the Windows Runtime is represented in C++/CX by the [Platform::String Class](../cppcx/platform-string-class.md). Use the `Platform::String Class` when you pass strings back and forth to methods in Windows Runtime classes, or when you are interacting with other Windows Runtime components across the application binary interface (ABI) boundary. The `Platform::String Class` provides methods for several common string operations, but it's not designed to be a full-featured string class. In your C++ module, use standard C++ string types such as [wstring](../standard-library/basic-string-class.md) for any significant text processing, and then convert the final result to [Platform::String^](../cppcx/platform-string-class.md) before you pass it to or from a public interface. It's easy and efficient to convert between `wstring` or `wchar_t*` and `Platform::String`.
@@ -68,5 +68,3 @@ void GetDecodedStrings(std::vector<std::wstring> strings)
6868
}
6969
```
7070

71-
## See Also
72-
[Built-in Types](https://msdn.microsoft.com/acc196fd-09da-4882-b554-6c94685ec75f)

‎docs/cppcx/threading-and-marshaling-c-cx.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -89,7 +89,7 @@ ref class MyOptions
8989
In Visual C++, when you create a reference to an in-proc Windows Runtime class that has a marshaling behavior of "None", the compiler issues warning C4451 but doesn't suggest that you consider using `Platform::Agile<T>`. The compiler can't offer any help beyond this warning, so it's your responsibility to use the class correctly and ensure that your code calls STA components only from the user-interface thread, and MTA components only from a background thread.
9090

9191
## Authoring agile Windows Runtime components
92-
When you define a ref class in C++/CX, it's agile by default—that is, it has `ThreadingModel`=Both and `MarshallingType`=Agile. If you're using the Windows Runtime C++ Template Library, you can make your class agile by deriving from `FtmBase`, which uses the `FreeThreadedMarshaller`. If you author a class that has `ThreadingModel`=Both or `ThreadingModel`=MTA, make sure that the class is thread-safe. For more information, see [Create and Consume Objects (WRL)](https://msdn.microsoft.com/d5e42216-e888-4f1f-865a-b5ccd0def73e).
92+
When you define a ref class in C++/CX, it's agile by default—that is, it has `ThreadingModel`=Both and `MarshallingType`=Agile. If you're using the Windows Runtime C++ Template Library, you can make your class agile by deriving from `FtmBase`, which uses the `FreeThreadedMarshaller`. If you author a class that has `ThreadingModel`=Both or `ThreadingModel`=MTA, make sure that the class is thread-safe.
9393

9494
You can modify the threading model and marshaling behavior of a ref class. However, if you make changes that render the class non-agile, you must understand the implications that are associated with those changes.
9595

‎docs/data/atl-database-classes-ole-db-templates.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -33,4 +33,4 @@ Microsoft provides several implementations of OLE DB, a set of COM interfaces th
3333
[Creating an OLE DB Provider](../data/oledb/creating-an-ole-db-provider.md)
3434
[OLE DB Consumer Templates Reference](../data/oledb/ole-db-consumer-templates-reference.md)
3535
[OLE DB Provider Templates Reference](../data/oledb/ole-db-provider-templates-reference.md)
36-
[OLE DB Templates Samples](https://msdn.microsoft.com/08958863-0b5f-41ad-ae99-fca7440c553c)
36+
[OLE DB Templates Samples](https://github.com/Microsoft/VCSamples)

‎docs/data/oledb/commands-and-tables.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -25,7 +25,7 @@ Command and Table Classes
2525

2626
- For data sources that support commands, you can use the `CCommand` class instead. To execute a command, call [Open](../../data/oledb/ccommand-open.md) on this class. As an alternative, you can call `Prepare` to prepare a command that you want to execute more than once.
2727

28-
`CCommand` has three template arguments: an accessor type, a rowset type, and a result type (`CNoMultipleResults`, by default, or `CMultipleResults`). If you specify `CMultipleResults`, the `CCommand` class supports the `IMultipleResults` interface and handles multiple rowsets. The [DBVIEWER](https://msdn.microsoft.com/07620f99-c347-4d09-9ebc-2459e8049832) sample shows how to handle the multiple results.
28+
`CCommand` has three template arguments: an accessor type, a rowset type, and a result type (`CNoMultipleResults`, by default, or `CMultipleResults`). If you specify `CMultipleResults`, the `CCommand` class supports the `IMultipleResults` interface and handles multiple rowsets. The [DBVIEWER](https://github.com/Microsoft/VCSamples) sample shows how to handle the multiple results.
2929

3030
## See Also
3131
[OLE DB Consumer Templates](../../data/oledb/ole-db-consumer-templates-cpp.md)

‎docs/data/oledb/determining-which-type-of-accessor-to-use.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -26,7 +26,7 @@ You can determine data types on a rowset at compile time or at run time.
2626
|`CDynamicAccessor`|Automatic.|No.|Useful if you do not know the type of data in a rowset.|
2727
|`CDynamicParameterAccessor`|Automatic, but can be [overridden](../../data/oledb/overriding-a-dynamic-accessor.md).|Yes, if the provider supports `ICommandWithParameters`. Parameters bound automatically.|Slower than `CDynamicAccessor` but useful for calling generic stored procedures.|
2828
|`CDynamicStringAccessor[A,W]`|Automatic.|No.|Retrieves data accessed from the data store as string data.|
29-
|`CManualAccessor`|Manual using `AddBindEntry`.|Manually using `AddParameterEntry`.|Very fast; parameters and columns bound only once. You determine the type of data to use. (See [DBVIEWER](https://msdn.microsoft.com/07620f99-c347-4d09-9ebc-2459e8049832) sample for an example.) Requires more code than `CDynamicAccessor` or `CAccessor`. It is more like calling OLE DB directly.|
29+
|`CManualAccessor`|Manual using `AddBindEntry`.|Manually using `AddParameterEntry`.|Very fast; parameters and columns bound only once. You determine the type of data to use. (See [DBVIEWER](https://github.com/Microsoft/VCSamples) sample for an example.) Requires more code than `CDynamicAccessor` or `CAccessor`. It is more like calling OLE DB directly.|
3030
|`CXMLAccessor`|Automatic.|No.|Retrieves data accessed from the data store as string data and formats it as XML-tagged data.|
3131

3232
## See Also

‎docs/data/oledb/idbschemarowsetimpl-class.md‎

Lines changed: 1 addition & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -237,8 +237,7 @@ STDMETHOD (GetSchema s )(ULONG * pcSchemas,
237237
The implementation of this function requires the user to have a schema map in the session class. Using the schema map information, it then responds with the array of GUIDs for the schemas in the map. This represents the schemas supported by the provider.
238238

239239
## See Also
240-
[IDBSchemaRowsetImpl Class Members](https://msdn.microsoft.com/e74f6f82-541c-42e7-b4c6-e2d4656a0649)
241240
[Schema Rowset Classes and Typedef Classes](../../data/oledb/schema-rowset-classes-and-typedef-classes.md)
242241
[Supporting Schema Rowsets](../../data/oledb/supporting-schema-rowsets.md)
243242
[SCHEMA_ENTRY](../../data/oledb/schema-entry.md)
244-
[UpdatePV](../../visual-cpp-samples.md)
243+
[UpdatePV](https://github.com/Microsoft/VCSamples)

‎docs/data/oledb/macros-for-ole-db-provider-templates.md‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -174,7 +174,7 @@ PROPERTY_INFO_ENTRY(dwPropID)
174174
[in] A [DBPROPID](/previous-versions/windows/desktop/ms723882\(v=vs.85\)) value that can be used in conjunction with the property set GUID to identify a property.
175175
176176
#### Remarks
177-
This macro sets the property value of type `DWORD` to a default value defined in ATLDB.H. To set the property to a value of your choosing, use [PROPERTY_INFO_ENTRY_VALUE](../../data/oledb/property-info-entry-value.md). To set the [VARTYPE](https://msdn.microsoft.com/317b911b-1805-402d-a9cb-159546bc88b4) and [DBPROPFLAGS](/previous-versions/windows/desktop/ms724342\(v=vs.85\)) for the property at the same time, use [PROPERTY_INFO_ENTRY_EX](../../data/oledb/property-info-entry-ex.md).
177+
This macro sets the property value of type `DWORD` to a default value defined in ATLDB.H. To set the property to a value of your choosing, use [PROPERTY_INFO_ENTRY_VALUE](../../data/oledb/property-info-entry-value.md). To set the `VARTYPE` and [DBPROPFLAGS](/previous-versions/windows/desktop/ms724342\(v=vs.85\)) for the property at the same time, use [PROPERTY_INFO_ENTRY_EX](../../data/oledb/property-info-entry-ex.md).
178178
179179
#### Example
180180
See [BEGIN_PROPSET_MAP](../../data/oledb/begin-propset-map.md).
@@ -193,7 +193,7 @@ PROPERTY_INFO_ENTRY_EX(dwPropID, vt, dwFlags, value, options)
193193
[in] A [DBPROPID](/previous-versions/windows/desktop/ms723882\(v=vs.85\)) value that can be used in conjunction with the property set GUID to identify a property.
194194

195195
*vt*
196-
[in] The [VARTYPE](https://msdn.microsoft.com/317b911b-1805-402d-a9cb-159546bc88b4) of this property entry.
196+
[in] The `VARTYPE` of this property entry. (Defined in wtypes.h)
197197

198198
*dwFlags*
199199
[in] A [DBPROPFLAGS](/previous-versions/windows/desktop/ms724342\(v=vs.85\)) value describing this property entry.

0 commit comments

Comments
 (0)