Merge pull request #4686 from corob-msft/learn/corob/cpp-docs-2128

Fix cpp-docs 2128, 4296

Author: Stacyrch140

docs/cpp/com-error-class.md

@@ -1,69 +1,69 @@
 ---
 description: "Learn more about: _com_error Class"
 title: "_com_error Class"
-ms.date: "11/04/2016"
+ms.date: 11/17/2022
 f1_keywords: ["_com_error"]
 helpviewer_keywords: ["_com_error class"]
 ms.assetid: 70dafa69-b1fb-4a5c-9249-e857e0793d42
 ---
-# _com_error Class
+# `_com_error` class
 
 **Microsoft Specific**
 
-A **_com_error** object represents an exception condition detected by the error-handling wrapper functions in the header files generated from the type library or by one of the COM support classes. The **_com_error** class encapsulates the HRESULT error code and any associated `IErrorInfo Interface` object.
+A `_com_error` object represents an exception condition detected by the error-handling wrapper functions in the header files generated from the type library or by one of the COM support classes. The `_com_error` class encapsulates the `HRESULT` error code and any associated `IErrorInfo Interface` object.
 
 ### Construction
 
 | Name | Description |
-|-|-|
-|[_com_error](../cpp/com-error-com-error.md)|Constructs a **_com_error** object.|
+|---|---|
+| [`_com_error`](../cpp/com-error-com-error.md) | Constructs a `_com_error` object. |
 
 ### Operators
 
 | Name | Description |
-|-|-|
-|[operator =](../cpp/com-error-operator-equal.md)|Assigns an existing **_com_error** object to another.|
+|---|---|
+| [`operator =`](../cpp/com-error-operator-equal.md) | Assigns an existing `_com_error` object to another. |
 
-### Extractor Functions
+### Extractor functions
 
 | Name | Description |
-|-|-|
-|[Error](../cpp/com-error-error.md)|Retrieves the HRESULT passed to the constructor.|
-|[ErrorInfo](../cpp/com-error-errorinfo.md)|Retrieves the `IErrorInfo` object passed to the constructor.|
-|[WCode](../cpp/com-error-wcode.md)|Retrieves the 16-bit error code mapped into the encapsulated HRESULT.|
+|---|---|
+| [`Error`](../cpp/com-error-error.md) | Retrieves the `HRESULT` passed to the constructor. |
+| [`ErrorInfo`](../cpp/com-error-errorinfo.md) | Retrieves the `IErrorInfo` object passed to the constructor. |
+| [`WCode`](../cpp/com-error-wcode.md) | Retrieves the 16-bit error code mapped into the encapsulated `HRESULT`. |
 
-### IErrorInfo Functions
+### `IErrorInfo` functions
 
 | Name | Description |
-|-|-|
-|[Description](../cpp/com-error-description.md)|Calls `IErrorInfo::GetDescription` function.|
-|[HelpContext](../cpp/com-error-helpcontext.md)|Calls `IErrorInfo::GetHelpContext` function.|
-|[HelpFile](../cpp/com-error-helpfile.md)|Calls `IErrorInfo::GetHelpFile` function|
-|[Source](../cpp/com-error-source.md)|Calls `IErrorInfo::GetSource` function.|
-|[GUID](../cpp/com-error-guid.md)|Calls `IErrorInfo::GetGUID` function.|
+|---|---|
+| [`Description`](../cpp/com-error-description.md) | Calls `IErrorInfo::GetDescription` function. |
+| [`HelpContext`](../cpp/com-error-helpcontext.md) | Calls `IErrorInfo::GetHelpContext` function. |
+| [`HelpFile`](../cpp/com-error-helpfile.md) | Calls `IErrorInfo::GetHelpFile` function |
+| [`Source`](../cpp/com-error-source.md) | Calls `IErrorInfo::GetSource` function. |
+| [`GUID`](../cpp/com-error-guid.md) | Calls `IErrorInfo::GetGUID` function. |
 
-### Format Message Extractor
+### Format message extractor
 
 | Name | Description |
-|-|-|
-|[ErrorMessage](../cpp/com-error-errormessage.md)|Retrieves the string message for HRESULT stored in the **_com_error** object.|
+|---|---|
+| [`ErrorMessage`](../cpp/com-error-errormessage.md) | Retrieves the string message for `HRESULT` stored in the `_com_error` object. |
 
-### ExepInfo.wCode to HRESULT Mappers
+### `ExepInfo.wCode` to `HRESULT` mappers
 
 | Name | Description |
-|-|-|
-|[HRESULTToWCode](../cpp/com-error-hresulttowcode.md)|Maps 32-bit HRESULT to 16-bit `wCode`.|
-|[WCodeToHRESULT](../cpp/com-error-wcodetohresult.md)|Maps 16-bit `wCode` to 32-bit HRESULT.|
+|---|---|
+| [`HRESULTToWCode`](../cpp/com-error-hresulttowcode.md) | Maps 32-bit `HRESULT` to 16-bit `wCode`. |
+| [`WCodeToHRESULT`](../cpp/com-error-wcodetohresult.md) | Maps 16-bit `wCode` to 32-bit `HRESULT`. |
 
 **END Microsoft Specific**
 
 ## Requirements
 
 **Header:** \<comdef.h>
 
-`Lib:` comsuppw.lib or comsuppwd.lib (see [/Zc:wchar_t (wchar_t Is Native Type)](../build/reference/zc-wchar-t-wchar-t-is-native-type.md) for more information)
+**Library:** *`comsuppw.lib`* or *`comsuppwd.lib`* (for more information, see [`/Zc:wchar_t` (wchar_t is native type)](../build/reference/zc-wchar-t-wchar-t-is-native-type.md))
 
 ## See also
 
-[Compiler COM Support Classes](../cpp/compiler-com-support-classes.md)<br/>
-[IErrorInfo Interface](/windows/win32/api/oaidl/nn-oaidl-ierrorinfo)
+[Compiler COM support classes](../cpp/compiler-com-support-classes.md)\
+[`IErrorInfo` interface](/windows/win32/api/oaidl/nn-oaidl-ierrorinfo)

docs/cpp/com-error-com-error.md

@@ -1,58 +1,58 @@
 ---
 description: "Learn more about: _com_error::_com_error"
 title: "_com_error::_com_error"
-ms.date: "11/04/2016"
-f1_keywords: ["_com_error::_com_error"]
-helpviewer_keywords: ["_com_error method [C++]"]
+ms.date: 11/17/2022
+f1_keywords: ["COMDEF/_com_error", "_com_error::_com_error"]
+helpviewer_keywords: ["_com_error constructor [C++]"]
 ms.assetid: 0a69e46c-caab-49ef-b091-eee401253ce6
 ---
-# _com_error::_com_error
+# `_com_error::_com_error`
 
 **Microsoft Specific**
 
-Constructs a **_com_error** object.
+Constructs a `_com_error` object.
 
 ## Syntax
 
-```
+```cpp
 _com_error(
    HRESULT hr,
    IErrorInfo* perrinfo = NULL,
-   bool fAddRef=false) throw( );
+   bool fAddRef = false) throw();
 
-_com_error( const _com_error& that ) throw( );
+_com_error( const _com_error& that ) throw();
 ```
 
-#### Parameters
+### Parameters
 
-*hr*<br/>
-HRESULT information.
+*`hr`*\
+`HRESULT` information.
 
-*perrinfo*<br/>
+*`perrinfo`*\
 `IErrorInfo` object.
 
-*fAddRef*<br/>
-The default causes the constructor to call AddRef on a non-null `IErrorInfo` interface. This provides for correct reference counting in the common case where ownership of the interface is passed into the **_com_error** object, such as:
+*`fAddRef`*\
+The default causes the constructor to not call AddRef on a non-null `IErrorInfo` interface. This behavior provides for correct reference counting in the common case where ownership of the interface is passed into the `_com_error` object, such as:
 
 ```cpp
 throw _com_error(hr, perrinfo);
 ```
 
-If you do not want your code to transfer ownership to the **_com_error** object, and the `AddRef` is required to offset the `Release` in the **_com_error** destructor, construct the object as follows:
+If you don't want your code to transfer ownership to the `_com_error` object, and the `AddRef` is required to offset the `Release` in the `_com_error` destructor, construct the object as follows:
 
 ```cpp
 _com_error err(hr, perrinfo, true);
 ```
 
-*that*<br/>
-An existing **_com_error** object.
+*`that`*\
+An existing `_com_error` object.
 
 ## Remarks
 
-The first constructor creates a new object given an HRESULT and optional `IErrorInfo` object. The second creates a copy of an existing **_com_error** object.
+The first constructor creates a new object given an `HRESULT` and optional `IErrorInfo` object. The second creates a copy of an existing `_com_error` object.
 
 **END Microsoft Specific**
 
 ## See also
 
-[_com_error Class](../cpp/com-error-class.md)
+[`_com_error` class](../cpp/com-error-class.md)

docs/cpp/com-error-description.md

@@ -1,24 +1,24 @@
 ---
 description: "Learn more about: _com_error::Description"
 title: "_com_error::Description"
-ms.date: "11/04/2016"
-f1_keywords: ["_com_error::Description"]
-helpviewer_keywords: ["Description method [C++]"]
+ms.date: 11/17/2022
+f1_keywords: ["COMDEF/_com_error::Description", "_com_error::Description"]
+helpviewer_keywords: ["_com_error Description method [C++]"]
 ms.assetid: 88191e24-4ee8-44a6-8c4c-3758e22e0548
 ---
-# _com_error::Description
+# `_com_error::Description`
 
 **Microsoft Specific**
 
 Calls `IErrorInfo::GetDescription` function.
 
 ## Syntax
 
-```
-_bstr_t Description( ) const;
+```cpp
+_bstr_t Description() const;
 ```
 
-## Return Value
+## Return value
 
 Returns the result of `IErrorInfo::GetDescription` for the `IErrorInfo` object recorded within the `_com_error` object. The resulting `BSTR` is encapsulated in a `_bstr_t` object. If no `IErrorInfo` is recorded, it returns an empty `_bstr_t`.
 
@@ -30,4 +30,4 @@ Calls the `IErrorInfo::GetDescription` function and retrieves `IErrorInfo` recor
 
 ## See also
 
-[_com_error Class](../cpp/com-error-class.md)
+[`_com_error` class](../cpp/com-error-class.md)

docs/cpp/com-error-error.md

@@ -1,33 +1,33 @@
 ---
 description: "Learn more about: _com_error::Error"
 title: "_com_error::Error"
-ms.date: "11/04/2016"
-f1_keywords: ["_com_error::Error", "Error"]
-helpviewer_keywords: ["Error method [C++]"]
+ms.date: 11/17/2022
+f1_keywords: ["COMDEF/_com_error::Error", "_com_error::Error"]
+helpviewer_keywords: ["_com_error Error method [C++]"]
 ms.assetid: b53a15fd-198e-4276-afcd-13439c4807f7
 ---
-# _com_error::Error
+# `_com_error::Error`
 
 **Microsoft Specific**
 
-Retrieves the HRESULT passed to the constructor.
+Retrieves the `HRESULT` passed to the constructor.
 
 ## Syntax
 
-```
-HRESULT Error( ) const throw( );
+```cpp
+HRESULT Error() const throw();
 ```
 
-## Return Value
+## Return value
 
-Raw HRESULT item passed into the constructor.
+Raw `HRESULT` item passed into the constructor.
 
 ## Remarks
 
-Retrieves the encapsulated HRESULT item in a `_com_error` object.
+Retrieves the encapsulated `HRESULT` item in a `_com_error` object.
 
 **END Microsoft Specific**
 
 ## See also
 
-[_com_error Class](../cpp/com-error-class.md)
+[`_com_error` class](../cpp/com-error-class.md)

docs/cpp/com-error-errorinfo.md

@@ -1,9 +1,9 @@
 ---
 description: "Learn more about: _com_error::ErrorInfo"
 title: "_com_error::ErrorInfo"
-ms.date: "11/04/2016"
-f1_keywords: ["_com_error::ErrorInfo"]
-helpviewer_keywords: ["ErrorInfo method [C++]"]
+ms.date: 11/17/2022
+f1_keywords: ["COMDEF/_com_error::ErrorInfo", "_com_error::ErrorInfo"]
+helpviewer_keywords: ["_com_error ErrorInfo method [C++]"]
 ms.assetid: 071b446c-4395-4fb8-bd3d-300a8b25f5cd
 ---
 # _com_error::ErrorInfo
@@ -14,20 +14,20 @@ Retrieves the `IErrorInfo` object passed to the constructor.
 
 ## Syntax
 
-```
+```cpp
 IErrorInfo * ErrorInfo( ) const throw( );
 ```
 
-## Return Value
+## Return value
 
 Raw `IErrorInfo` item passed into the constructor.
 
 ## Remarks
 
-Retrieves the encapsulated `IErrorInfo` item in a `_com_error` object, or NULL if no `IErrorInfo` item is recorded. The caller must call `Release` on the returned object when finished using it.
+Retrieves the encapsulated `IErrorInfo` item in a `_com_error` object, or `NULL` if no `IErrorInfo` item is recorded. The caller must call `Release` on the returned object when finished using it.
 
 **END Microsoft Specific**
 
 ## See also
 
-[_com_error Class](../cpp/com-error-class.md)
+[`_com_error` class](../cpp/com-error-class.md)

docs/cpp/com-error-errormessage.md

@@ -1,33 +1,33 @@
 ---
 description: "Learn more about: _com_error::ErrorMessage"
 title: "_com_error::ErrorMessage"
-ms.date: "11/04/2016"
-f1_keywords: ["_com_error::ErrorMessage"]
-helpviewer_keywords: ["ErrorMessage method [C++]"]
+ms.date: 11/17/2022
+f1_keywords: ["COMDEF/_com_error::ErrorMessage", "_com_error::ErrorMessage"]
+helpviewer_keywords: ["_com_error ErrorMessage method [C++]"]
 ms.assetid: e47335b6-01af-4975-a841-121597479eb7
 ---
-# _com_error::ErrorMessage
+# `_com_error::ErrorMessage`
 
 **Microsoft Specific**
 
-Retrieves the string message for HRESULT stored in the `_com_error` object.
+Retrieves the string message for `HRESULT` stored in the `_com_error` object.
 
 ## Syntax
 
-```
-const TCHAR * ErrorMessage( ) const throw( );
+```cpp
+const TCHAR * ErrorMessage() const throw();
 ```
 
-## Return Value
+## Return value
 
-Returns the string message for the HRESULT recorded within the `_com_error` object. If the HRESULT is a mapped 16-bit [wCode](../cpp/com-error-wcode.md), then a generic message "`IDispatch error #<wCode>`" is returned. If no message is found, then a generic message "`Unknown error #<hresult>`" is returned. The returned string is either a Unicode or multibyte string, depending on the state of the _UNICODE macro.
+Returns the string message for the `HRESULT` recorded within the `_com_error` object. If the `HRESULT` is a mapped 16-bit [`wCode`](../cpp/com-error-wcode.md), then a generic message "`IDispatch error #<wCode>`" is returned. If no message is found, then a generic message "`Unknown error #<hresult>`" is returned. The returned string is either a Unicode or multibyte string, depending on the state of the `_UNICODE` macro.
 
 ## Remarks
 
-Retrieves the appropriate system message text for HRESULT recorded within the `_com_error` object. The system message text is obtained by calling the Win32 [FormatMessage](/windows/win32/api/winbase/nf-winbase-formatmessage) function. The string returned is allocated by the `FormatMessage` API, and it is released when the `_com_error` object is destroyed.
+Retrieves the appropriate system message text for `HRESULT` recorded within the `_com_error` object. The system message text is obtained by calling the Win32 [`FormatMessage`](/windows/win32/api/winbase/nf-winbase-formatmessage) function. The string returned is allocated by the `FormatMessage` API, and it's released when the `_com_error` object is destroyed.
 
 **END Microsoft Specific**
 
 ## See also
 
-[_com_error Class](../cpp/com-error-class.md)
+[`_com_error` class](../cpp/com-error-class.md)

docs/cpp/com-error-guid.md

@@ -1,24 +1,24 @@
 ---
 description: "Learn more about: _com_error::GUID"
 title: "_com_error::GUID"
-ms.date: "11/04/2016"
-f1_keywords: ["_com_error::GUID"]
-helpviewer_keywords: ["GUID method [C++]"]
+ms.date: 11/17/2022
+f1_keywords: ["COMDEF/_com_error::GUID", "_com_error::GUID"]
+helpviewer_keywords: ["_com_error GUID method [C++]"]
 ms.assetid: e84c2c23-d02e-48f8-b776-9bd6937296d2
 ---
-# _com_error::GUID
+# `_com_error::GUID`
 
 **Microsoft Specific**
 
 Calls `IErrorInfo::GetGUID` function.
 
 ## Syntax
 
-```
-GUID GUID( ) const throw( );
+```cpp
+GUID GUID() const throw();
 ```
 
-## Return Value
+## Return value
 
 Returns the result of `IErrorInfo::GetGUID` for the `IErrorInfo` object recorded within the `_com_error` object. If no `IErrorInfo` object is recorded, it returns `GUID_NULL`.
 
@@ -30,4 +30,4 @@ Any failure while calling the `IErrorInfo::GetGUID` method is ignored.
 
 ## See also
 
-[_com_error Class](../cpp/com-error-class.md)
+[`_com_error` class](../cpp/com-error-class.md)