Merge pull request #3156 from MicrosoftDocs/master

9/17/2020 AM Publish

Author: Taojunshen

docs/atl/reference/debugging-and-error-reporting-global-functions.md

@@ -185,7 +185,7 @@ For ATL projects, it is possible to provide your own implementation of this func
 
 [!code-cpp[NVC_ATL_Windowing#95](../../atl/codesnippet/cpp/debugging-and-error-reporting-global-functions_2.h)]
 
-## Requirements
+### Requirements
 
 **Header:** atldef.h
 
@@ -207,7 +207,7 @@ If _ATL_NO_EXCEPTIONS is not defined in an ATL project, the function throws a [C
 
 If _ATL_NO_EXCEPTIONS is defined, the function causes an assertion failure instead of throwing an exception.
 
-## Requirements
+### Requirements
 
 **Header:** atldef.h
 

docs/build-insights/reference/sdk/other-types/tracing-session-options-struct.md

@@ -1,6 +1,6 @@
 ---
 title: "TRACING_SESSION_OPTIONS structure"
-description: "The C++ Build Insights SDK TRACING_SESSION_OPTIONS structure reference."
+description: "Learn about the C++ Build Insights SDK TRACING_SESSION_OPTIONS structure reference."
 ms.date: "02/12/2020"
 helpviewer_keywords: ["C++ Build Insights", "C++ Build Insights SDK", "TRACING_SESSION_OPTIONS", "throughput analysis", "build time analysis", "vcperf.exe"]
 ---

docs/build-insights/reference/sdk/other-types/tracing-session-statistics-struct.md

@@ -1,6 +1,6 @@
 ---
 title: "TRACING_SESSION_STATISTICS structure"
-description: "The C++ Build Insights SDK TRACING_SESSION_OPTIONS structure reference."
+description: "Learn about the C++ Build Insights SDK TRACING_SESSION_STATISTICS structure reference."
 ms.date: "02/12/2020"
 helpviewer_keywords: ["C++ Build Insights", "C++ Build Insights SDK", "TRACING_SESSION_STATISTICS", "throughput analysis", "build time analysis", "vcperf.exe"]
 ---

docs/build/reference/errorreport-report-internal-linker-errors.md

@@ -1,6 +1,6 @@
 ---
 title: "/ERRORREPORT (Report internal linker errors)"
-description: "Reference guide to the Microsoft NMAKE command-line options."
+description: "Learn how to use /ERRORREPORT."
 ms.date: "02/09/2020"
 f1_keywords: ["/ERRORREPORT", "VC.Project.VCLinkerTool.ErrorReporting"]
 helpviewer_keywords: ["/ERRORREPORT linker option", "ERRORREPORT linker option", "-ERRORREPORT linker option"]

docs/build/reference/running-nmake.md

@@ -1,6 +1,6 @@
 ---
 title: "Running NMAKE"
-description: "Reference guide to the Microsoft NMAKE command-line options."
+description: "Learn about running NMAKE."
 ms.date: "02/09/2020"
 helpviewer_keywords: ["targets, building", "response files, NMAKE", "targets", "command files", "NMAKE program, targets", "NMAKE program, running", "command files, NMAKE"]
 ms.assetid: 0421104d-8b7b-4bf3-86c1-928d9b7c1a8c

docs/c-runtime-library/reference/fopen-wfopen.md

@@ -121,6 +121,7 @@ The following options can be appended to *mode* to specify additional behaviors.
 
 |*mode* modifier|Behavior|
 |-|-|
+| **x** | Forces the function to fail if *filename* already exists. Can only be used with the "w" or "w+" specifiers. |
 | **c** | Enable the commit flag for the associated *filename* so that the contents of the file buffer are written directly to disk if either **fflush** or **_flushall** is called. |
 | **n** | Reset the commit flag for the associated *filename* to "no-commit." This is the default. It also overrides the global commit flag if you link your program with COMMODE.OBJ. The global commit flag default is "no-commit" unless you explicitly link your program with COMMODE.OBJ (see [Link Options](../../c-runtime-library/link-options.md)). |
 | **N** | Specifies that the file is not inherited by child processes. |
@@ -142,6 +143,7 @@ Valid characters for the *mode* string that is used in **fopen** and **_fdopen**
 |**w+**|**\_O\_RDWR** (usually **\_O\_RDWR** | **\_O\_CREAT** | **\_O\_TRUNC**)|
 |**b**|**\_O\_BINARY**|
 |**t**|**\_O\_TEXT**|
+|**x**|**\_O\_EXCL**|
 |**c**|None|
 |**n**|None|
 |**S**|**\_O\_SEQUENTIAL**|

docs/code-quality/c26439.md

@@ -5,7 +5,7 @@ ms.topic: "conceptual"
 f1_keywords: ["C26439"]
 helpviewer_keywords: ["C26439"]
 ms.assetid: 9df2a1b0-ea94-4884-9d28-c1522ec33a1b
-description: CppCoreCheck rule that enforces C++ Core Guidelines F.6
+description: CppCoreCheck rule C26439 that enforces C++ Core Guidelines F.6
 ---
 # C26439 SPECIAL_NOEXCEPT
 

docs/code-quality/c26440.md

@@ -5,7 +5,7 @@ ms.topic: "conceptual"
 f1_keywords: ["C26440"]
 helpviewer_keywords: ["C26440"]
 ms.assetid: b6d2b188-35cc-4de2-878c-6f97d5a2444a
-description: CppCoreCheck rule that enforces C++ Core Guidelines F.6
+description: CppCoreCheck rule C26440 that enforces C++ Core Guidelines F.6
 ---
 # C26440 DECLARE_NOEXCEPT
 

docs/code-quality/c26462.md

@@ -4,7 +4,7 @@ ms.date: 03/22/2018
 ms.topic: reference
 f1_keywords: ["C26462"]
 helpviewer_keywords: ["C26462"]
-description: CppCoreCheck rule that enforces C++ Core Guidelines Con.4
+description: CppCoreCheck rule C26462 that enforces C++ Core Guidelines Con.4
 ---
 # C26462 USE_CONST_POINTER_FOR_VARIABLE
 

docs/code-quality/c26463.md

@@ -4,7 +4,7 @@ ms.date: 03/22/2018
 ms.topic: reference
 f1_keywords: ["C26463"]
 helpviewer_keywords: ["C26463"]
-description: CppCoreCheck placeholder warning for future con.4 enforcement
+description: CppCoreCheck placeholder warning C26463 for future con.4 enforcement
 ---
 # C26463 USE_CONST_FOR_ELEMENTS
 

docs/code-quality/c26464.md

@@ -4,7 +4,7 @@ ms.date: 03/22/2018
 ms.topic: reference
 f1_keywords: ["C26464"]
 helpviewer_keywords: ["C26464"]
-description: CppCoreCheck placeholder warning for future con.4 enforcement
+description: CppCoreCheck placeholder warning C26464 for future con.4 enforcement
 ---
 # C26464 USE_CONST_POINTER_FOR_ELEMENTS
 

docs/code-quality/c26465.md

@@ -4,7 +4,7 @@ ms.date: 03/22/2018
 ms.topic: reference
 f1_keywords: ["C26465"]
 helpviewer_keywords: ["C26465"]
-description: CppCoreCheck rule that enforces C++ Core Guidelines Type.3
+description: CppCoreCheck rule C26465 that enforces C++ Core Guidelines Type.3
 ---
 # C26465 NO_CONST_CAST_UNNECESSARY
 

docs/code-quality/c26471.md

@@ -4,7 +4,7 @@ ms.date: 03/22/2018
 ms.topic: reference
 f1_keywords: ["C26471"]
 helpviewer_keywords: ["C26471"]
-description: CppCoreCheck rule that enforces C++ Core Guidelines Type.1
+description: CppCoreCheck rule C26471 that enforces C++ Core Guidelines Type.1
 ---
 # C26471 NO_REINTERPRET_CAST_FROM_VOID_PTR
 

docs/code-quality/c26482.md

@@ -4,7 +4,7 @@ ms.date: 03/22/2018
 ms.topic: reference
 f1_keywords: ["C26482"]
 helpviewer_keywords: ["C26482"]
-description: CppCoreCheck rule that enforces C++ Core Guidelines Bounds.2
+description: CppCoreCheck rule C26482 that enforces C++ Core Guidelines Bounds.2
 ---
 # C26482 NO_DYNAMIC_ARRAY_INDEXING
 

docs/code-quality/c26483.md

@@ -4,7 +4,7 @@ ms.date: 03/22/2018
 ms.topic: reference
 f1_keywords: ["C26483"]
 helpviewer_keywords: ["C26483"]
-description: CppCoreCheck rule that enforces C++ Core Guidelines Bounds.2
+description: CppCoreCheck rule C26483 that enforces C++ Core Guidelines Bounds.2
 ---
 # C26483 STATIC_INDEX_OUT_OF_RANGE
 

docs/code-quality/c26490.md

@@ -4,7 +4,7 @@ ms.date: 03/22/2018
 ms.topic: reference
 f1_keywords: ["C26490"]
 helpviewer_keywords: ["C26490"]
-description: CppCoreCheck rule that enforces C++ Core Guidelines Type.1
+description: CppCoreCheck rule C26490 that enforces C++ Core Guidelines Type.1
 ---
 # C26490 NO_REINTERPRET_CAST
 

docs/code-quality/c26492.md

@@ -4,7 +4,7 @@ ms.date: 03/22/2018
 ms.topic: reference
 f1_keywords: ["C26492"]
 helpviewer_keywords: ["C26492"]
-description: CppCoreCheck rule that enforces C++ Core Guidelines Type.3
+description: CppCoreCheck rule C26492 that enforces C++ Core Guidelines Type.3
 ---
 # C26492 NO_CONST_CAST
 

docs/code-quality/c26496.md

@@ -4,7 +4,7 @@ ms.date: 03/22/2018
 ms.topic: reference
 f1_keywords: ["C26496"]
 helpviewer_keywords: ["C26496"]
-description: CppCoreCheck rule that enforces C++ Core Guidelines Con.4
+description: CppCoreCheck rule C26496 that enforces C++ Core Guidelines Con.4
 ---
 # C26496 USE_CONST_FOR_VARIABLE
 

docs/code-quality/c6297.md

@@ -1,6 +1,6 @@
 ---
 title: C6297
-description: "Describes causes of MSVC Code analysis warning C26452, and how to fix the issue."
+description: "Describes causes of MSVC Code analysis warning C6297, and how to fix the issue."
 ms.date: 07/15/2020
 f1_keywords: ["C6297"]
 helpviewer_keywords: ["C6297"]

docs/cpp/static-assert.md

@@ -35,21 +35,21 @@ The compiler examines the **`static_assert`** declaration for syntax errors when
 
 You can use the **`static_assert`** keyword at namespace, class, or block scope. (The **`static_assert`** keyword is technically a declaration, even though it does not introduce new name into your program, because it can be used at namespace scope.)
 
-## Description
+## Description of static_assert with namespace scope
 
 In the following example, the **`static_assert`** declaration has namespace scope. Because the compiler knows the size of type `void *`, the expression is evaluated immediately.
 
-## Example
+## Example of static_assert with namespace scope
 
 ```cpp
 static_assert(sizeof(void *) == 4, "64-bit code generation is not supported.");
 ```
 
-## Description
+## Description of static_assert with class scope
 
 In the following example, the **`static_assert`** declaration has class scope. The **`static_assert`** verifies that a template parameter is a *plain old data* (POD) type. The compiler examines the **`static_assert`** declaration when it is declared, but does not evaluate the *constant-expression* parameter until the `basic_string` class template is instantiated in `main()`.
 
-## Example
+## Example of static_assert with class scope
 
 ```cpp
 #include <type_traits>

docs/cppcx/platform-agile-class.md

@@ -73,7 +73,7 @@ The `Agile<T>` class is a native, standard C++ class and requires `agile.h`. It
 
 Initializes a new instance of the Agile class.
 
-## Syntax
+### Syntax
 
 ```cpp
 Agile();
@@ -98,7 +98,7 @@ The first version of this constructor is the default constructor. The second ver
 
 Destroys the current instance of the Agile class.
 
-## Syntax
+### Syntax
 
 ```cpp
 ~Agile();
@@ -112,7 +112,7 @@ This destructor also releases the object represented by the current Agile object
 
 Returns a handle to the object that is represented by the current Agile object.
 
-## Syntax
+### Syntax
 
 ```cpp
 T^ Get() const;
@@ -128,7 +128,7 @@ The type of the return value is actually an undisclosed internal type. A conveni
 
 Reinitializes the current Agile object, and then returns the address of a handle to an object of type `T`.
 
-## Syntax
+### Syntax
 
 ```cpp
 T^* GetAddressOf() throw();
@@ -151,7 +151,7 @@ This operation releases the current representation of a object of type `T`, if a
 
 Returns the address of a handle to the object represented by the current Agile object.
 
-## Syntax
+### Syntax
 
 ```cpp
 T^* GetAddressOfForInOut()  throw();
@@ -174,7 +174,7 @@ This operation acquires the current threading context and then returns the addre
 
 Discards the current Agile object's underlying object and context.
 
-## Syntax
+### Syntax
 
 ```cpp
 void Release() throw();
@@ -188,7 +188,7 @@ The current Agile object's underlying object and context are discarded, if they
 
 Retrieves a handle to the object represented by the current Agile object.
 
-## Syntax
+### Syntax
 
 ```cpp
 T^ operator->() const throw();
@@ -204,7 +204,7 @@ This operator actually returns an undisclosed internal type. A convenient way to
 
 Assigns the specified object to the current Agile object.
 
-## Syntax
+### Syntax
 
 ```cpp
 Agile<T> operator=( T^ object ) throw();

docs/cppcx/platform-array-class.md

@@ -57,7 +57,7 @@ Compiler option: **/ZW**
 
 Initializes a one-dimensional, modifiable array of types specified by the class template parameter, *T*.
 
-## Syntax
+### Syntax
 
 ```cpp
 Array(unsigned int size);
@@ -83,7 +83,7 @@ For more information about how to create instances of Platform::Array, see [Arra
 
 Retrieves a reference to the array element at the specified index location.
 
-## Syntax
+### Syntax
 
 ```cpp
 T& get(unsigned int index)  const;
@@ -102,7 +102,7 @@ The array element specified by the `index` parameter.
 
 Retrieves a handle to the current array.
 
-## Syntax
+### Syntax
 
 ```cpp
 property Array^ Value;

docs/cppcx/platform-collections-backinsertiterator-class.md

@@ -57,7 +57,7 @@ The BackInsertIterator class implements the rules required by the [back_insert_i
 
 Initializes a new instance of the `BackInsertIterator` class.
 
-## Syntax
+### Syntax
 
 ```
 explicit BackInsertIterator(
@@ -77,7 +77,7 @@ A `BackInsertIterator` inserts elements after the last element of the object spe
 
 Appends the specified object to the end of the current sequential collection.
 
-## Syntax
+### Syntax
 
 ```
 BackInsertIterator& operator=( const T& t);
@@ -96,7 +96,7 @@ A reference to the current BackInsertIterator.
 
 Retrieves a reference to the current BackInsertIterator.
 
-## Syntax
+### Syntax
 
 ```
 BackInsertIterator& operator*();
@@ -114,7 +114,7 @@ This operator returns a reference to the current BackInsertIterator; not to any
 
 Returns a reference to the current BackInsertIterator. The iterator is unmodified.
 
-## Syntax
+### Syntax
 
 ```
 BackInsertIterator& operator++();

docs/cppcx/platform-exception-class.md

@@ -114,7 +114,7 @@ public:
     property int HResult { int get(); }
 ```
 
-## Property Value
+### Property Value
 
 An HRESULT value.
 
@@ -132,7 +132,7 @@ Message that describes the error.
 public:property String^ Message;
 ```
 
-## Property Value
+### Property Value
 
 In exceptions that originate in the Windows Runtime, this is a system-supplied description of the error.
 

docs/data/oledb/cmyprovidersource-myproviderds-h.md

@@ -30,27 +30,6 @@ The data source object also inherits from several 'Impl' classes. Each class pro
 
 Whenever the client calls `QueryInterface` for an interface on the data source, it goes through the following COM map:
 
-```cpp
-/////////////////////////////////////////////////////////////////////////
-// CCustomSource
-class ATL_NO_VTABLE CCustomSource :
-   public CComObjectRootEx<CComSingleThreadModel>,
-   public CComCoClass<CCustomSource, &CLSID_Custom>,
-   public IDBCreateSessionImpl<CCustomSource, CCustomSession>,
-   public IDBInitializeImpl<CCustomSource>,
-   public IDBPropertiesImpl<CCustomSource>,
-   public IPersistImpl<CCustomSource>,
-   public IInternalConnectionImpl<CCustomSource>
-```
-
-All the COM components derive from `CComObjectRootEx` and `CComCoClass`. `CComObjectRootEx` provides all the implementation for the `IUnknown` interface. It can handle any threading model. `CComCoClass` handles any error support required. If you want to send richer error information to the client, you can use some of the error APIs in `CComCoClass`.
-
-The data source object also inherits from several 'Impl' classes. Each class provides the implementation for an interface. The data source object implements the `IPersist`, `IDBProperties`, `IDBInitialize`, and `IDBCreateSession` interfaces. Each interface is required by OLE DB to implement the data source object. You can choose to support or not support particular functionality by inheriting or not inheriting from one of these 'Impl' classes. If you want to support the `IDBDataSourceAdmin` interface, you inherit from the `IDBDataSourceAdminImpl` class to get the functionality required.
-
-## COM Map
-
-Whenever the client calls `QueryInterface` for an interface on the data source, it goes through the following COM map:
-
 ```cpp
 BEGIN_COM_MAP(CCustomSource)
    COM_INTERFACE_ENTRY(IDBCreateSession)