4/13/2022 AM Publish (MicrosoftDocs#4218)

Taojunshen · Steve Wishnousky · rachana-satao · web-flow · commit e933bedcfeb1 · 2022-04-14T01:30:07.000+08:00
* Update open-wopen.md Clarify that _O_TEMPORARY sets FILE_SHARE_DELETE. * Update other pages that mention _O_TEMPORARY effects. * New article - IDL method wizard * update after review * update after review * Update after review * Update after review * Updating - Add property wizard for VS2022 * Updating broken links * Update after review * New article - Add an IDL Property * link updation * Update after review * update after review * update after review * Broken link fixed * Broken link fixed * Update virtual-functions.md * update for links * Updating links * Address cpp-docs 3780 3782 3790 3791 3805 * Attempt correction of table format * Add documentation for compiler error C2956 and update error text (MicrosoftDocs#4176) * Add documentation for compiler error C2956 and update error text * Add TOC entry * Update for grammar and my own comprehension. Sometimes, you just get carried away. This version could use some simplification. * Simplify. Address remarks, attempt simplification. Acrolinx all the things. * More updates per review Co-authored-by: Colin Robertson <corob@microsoft.com> * Address cpp-docs 3816 * Address non-blocking issues from 4207 * fix for sample program. * edits * edit pass. Move to ide location * minor edit * fix link * Final update * final update * final update * resolving blocking issue * resolving blocking issue * ToC update * link update * Correct inconsistent formatting for the `_O_EXCL` constant in the docs for the open functions * Update c28195.md * Update in alt-text * Update in alt-text * edit pass * edit pass * more cleanup * typo * small edit * Final update Co-authored-by: Steve Wishnousky <stwish@microsoft.com> Co-authored-by: rachana-satao <83084319+rachana-satao@users.noreply.github.com> Co-authored-by: opbld15 <opbld15@microsoft.com> Co-authored-by: Colin Robertson <corob@microsoft.com> Co-authored-by: opbld16 <opbld16@microsoft.com> Co-authored-by: opbld17 <opbld17@microsoft.com> Co-authored-by: atikmapari <31974726+atikmapari@users.noreply.github.com> Co-authored-by: PRMerger19 <prmrgr19@microsoft.com> Co-authored-by: Ming Ho <94572161+homing1@users.noreply.github.com> Co-authored-by: PRMerger5 <prmergr5@microsoft.com> Co-authored-by: Regan Downer <97987445+v-regandowner@users.noreply.github.com> Co-authored-by: Jonathan Emmett <joemmett@microsoft.com> Co-authored-by: Tamara K <93546702+tamarakhader@users.noreply.github.com> Co-authored-by: TylerMSFT <Tyler.Whitney@microsoft.com> Co-authored-by: PRMerger17 <prmrgr17@microsoft.com> Co-authored-by: Paula Miller <v-paulmi@microsoft.com> Co-authored-by: Martin Storsjö <martin@martin.st> Co-authored-by: Sunny Chatterjee <sunnych@microsoft.com> Co-authored-by: Tyler Whitney <TylerMSFT@users.noreply.github.com>
diff --git a/docs/c-runtime-library/reference/open-wopen.md b/docs/c-runtime-library/reference/open-wopen.md
@@ -73,7 +73,7 @@ The **`_open`** function opens the file specified by *`filename`* and prepares i
 | **`_O_CREAT`** | Creates a file and opens it for writing. Has no effect if the file specified by *filename* exists. The *pmode* argument is required when **`_O_CREAT`** is specified. |
 | **`_O_CREAT`** &#124; **`_O_SHORT_LIVED`** | Creates a file as temporary and if possible does not flush to disk. The *pmode* argument is required when **`_O_CREAT`** is specified. |
 | **`_O_CREAT`** &#124; **`_O_TEMPORARY`** | Creates a file as temporary; the file is deleted when the last file descriptor is closed. The *pmode* argument is required when **`_O_CREAT`** is specified. To preserve legacy behavior for app-compatibility, other processes are not prevented from deleting this file. |
-| **`_O_CREAT`** &#124; `_O_EXCL` | Returns an error value if a file specified by *filename* exists. Applies only when used with **`_O_CREAT`**. |
+| **`_O_CREAT`** &#124; **`_O_EXCL`** | Returns an error value if a file specified by *filename* exists. Applies only when used with **`_O_CREAT`**. |
 | **`_O_NOINHERIT`** | Prevents creation of a shared file descriptor. |
 | **`_O_RANDOM`** | Specifies that caching is optimized for, but not restricted to, random access from disk. |
 | **`_O_RDONLY`** | Opens a file for reading only. Cannot be specified with **`_O_RDWR`** or **`_O_WRONLY`**. |
diff --git a/docs/c-runtime-library/reference/sopen-s-wsopen-s.md b/docs/c-runtime-library/reference/sopen-s-wsopen-s.md
@@ -89,7 +89,7 @@ The integer expression *oflag* is formed by combining one or more manifest const
 | **`_O_CREAT`** | Creates a file and opens it for writing. Has no effect if the file specified by *`filename`* exists. The *`pmode`* argument is required when **`_O_CREAT`** is specified. |
 | **`_O_CREAT`** &#124; **`_O_SHORT_LIVED`** | Creates a file as temporary and if possible does not flush to disk. The *`pmode`* argument is required when **`_O_CREAT`** is specified. |
 | **`_O_CREAT`** &#124; **`_O_TEMPORARY`** | Creates a file as temporary; the file is deleted when the last file descriptor is closed. The *`pmode`* argument is required when **`_O_CREAT`** is specified. To preserve legacy behavior for app-compatibility, other processes are not prevented from deleting this file. |
-| **`_O_CREAT`** &#124; `_O_EXCL` | Returns an error value if a file specified by *`filename`* exists. Applies only when used with **`_O_CREAT`**. |
+| **`_O_CREAT`** &#124; **`_O_EXCL`** | Returns an error value if a file specified by *`filename`* exists. Applies only when used with **`_O_CREAT`**. |
 | **`_O_NOINHERIT`** | Prevents creation of a shared file descriptor. |
 | **`_O_RANDOM`** | Specifies that caching is optimized for, but not restricted to, random access from disk. |
 | **`_O_RDONLY`** | Opens a file for reading only. Cannot be specified with **`_O_RDWR`** or **`_O_WRONLY`**. |
diff --git a/docs/c-runtime-library/reference/sopen-wsopen.md b/docs/c-runtime-library/reference/sopen-wsopen.md
@@ -82,7 +82,7 @@ The integer expression *oflag* is formed by combining one or more of the followi
 | **_O_CREAT** | Creates a file and opens it for writing. Has no effect if the file specified by *filename* exists. The *pmode* argument is required when **_O_CREAT** is specified. |
 | **_O_CREAT** &#124; **_O_SHORT_LIVED** | Creates a file as temporary and if possible does not flush to disk. The *pmode* argument is required when **_O_CREAT** is specified. |
 | **_O_CREAT** &#124; **_O_TEMPORARY** | Creates a file as temporary; the file is deleted when the last file descriptor is closed. The *pmode* argument is required when **_O_CREAT** is specified. To preserve legacy behavior for app-compatibility, other processes are not prevented from deleting this file. |
-| **_O_CREAT** &#124; `_O_EXCL` | Returns an error value if a file specified by *filename* exists. Applies only when used with **_O_CREAT**. |
+| **_O_CREAT** &#124; **`_O_EXCL`** | Returns an error value if a file specified by *filename* exists. Applies only when used with **_O_CREAT**. |
 | **_O_NOINHERIT** | Prevents creation of a shared file descriptor. |
 | **_O_RANDOM** | Specifies that caching is optimized for, but not restricted to, random access from disk. |
 | **_O_RDONLY** | Opens a file for reading only. Cannot be specified with **_O_RDWR** or **_O_WRONLY**. |
diff --git a/docs/ide/add-interface-definition-library-method-wizard.md b/docs/ide/add-interface-definition-library-method-wizard.md
@@ -0,0 +1,117 @@
+---
+description: "Learn more about: Use a Microsoft Visual Studio wizard to add a method to an interface definition language (IDL) interface in your project"
+title: "Add an IDL method"
+ms.date: "04/13/2022"
+f1_keywords: ["vc.codewiz.method.overview", "vc.codewiz.method.idlattrib"]
+helpviewer_keywords: ["add IDL method wizard [C++]", "IDL methods [C++], adding", "methods [C++], adding using wizards", "IDL attributes, add an IDL method wizard"]
+ms.custom: devdivchpfy22
+---
+
+# Add an IDL method
+
+The **Add IDL Method** wizard adds a method to an Interface Definition Library (IDL) interface, such as in an ATL project that contains an IDL file. This wizard isn't available in projects that support MFC.
+
+This wizard differs from the [**Add method**](adding-a-method-visual-cpp.md) wizard and the [**Add IDL MFC method**](../mfc/reference/add-idl-mfc-method-wizard.md) wizard in the following ways:
+
+- The **Add method** wizard adds a method to an interface in your project and can update the class associated with the interface.
+- The **Add IDL MFC method** wizard is specific to MFC, ActiveX, or ATL projects that support MFC.
+
+## Add a method to your IDL interface
+
+1. On the **View** menu, select **Class View**.
+
+1. In the **Class View** pane, expand the project node to display the IDL interface (`.idl`file) to which you want to add the method.
+
+1. Right-click the name of the interface.
+
+1. On the shortcut menu, select **Add** > **Add Method**.
+
+1. In the **Add IDL Method** wizard, provide the information to create the method.
+
+1. Select **OK** to add the method.
+
+### User Interface element list
+
+The following section describes the wizard interface that you'll use to add a method:
+
+:::image type="content" source= "media/add-interface-definition-library-method-wizard.png" alt-text="Screenshot of adding a method using the wizard. Shows two parameters: [ in ] int i and [ in ] float f. Return type is HRESULT. Infer in out parameter values from type is selected.":::
+
+- **Method name**
+
+  Provide a name for the method.
+
+- **Return type**
+
+  The data type returned by the method. The standard way to return error codes from methods defined in an interface is with a `HRESULT`.
+
+  The following table describes the different kinds of interfaces that you can add a method to, and the allowed return type. For dual and custom interfaces, the return type must be `HRESULT` and the wizard won't allow you to change it.
+
+  |Interface kind|Return type|
+  |--------------------|-----------------|
+  |[Dual interface](/windows/win32/winauto/dual-interfaces--iaccessible-and-idispatch)|`HRESULT`. Unchangeable.|
+  |[Custom interface](/windows/win32/winauto/custom-user-interface-elements)|`HRESULT`. Unchangeable.|
+  |Local custom interface|Provide your own return type or select it from the drop-down list.|
+  |[Dispinterface](/windows/win32/midl/dispinterface)|Provide your own return type or select it from the drop-down list.|
+
+- **Parameters**
+
+  Displays the method's parameters, modifiers, and types.
+
+- **+**
+
+  Add a parameter. In **Parameters**, type the parameter type, name, and any modifiers. For example, `[in] int i`, and choose **OK**.
+
+- **x**
+
+  Removes the selected parameter from the **Parameters** list.
+
+- **Infer in/out parameters values from types**
+
+  Inserts the `[in]` or `[out]` attribute based on the parameter's type.
+
+- **Set the last parameter as the return value (retval)**
+
+  The last parameter will be treated as the method's return value.
+
+- **Attributes**
+
+  The following attributes are also described in the [MIDL Reference](/windows/win32/midl/midl-language-reference.md).
+
+  - `id`
+
+    Sets the numeric ID that identifies the method. For more information, see [`id`](/windows/win32/Midl/id).
+
+  - `call_as`
+
+    Specifies the name of the remote method to map to this local method. For more information, see [`call_as`](/windows/win32/Midl/call-as).
+
+  - `helpcontext`
+
+    Specifies a context ID that lets the user view information about this method in the Help file. For more information, see [`helpcontext`](/windows/win32/Midl/helpcontext).
+
+  - `helpstring`
+
+    Specifies the character string used to describe the element to which it applies. For more information, see [`helpstring`](/windows/win32/Midl/helpstring).
+
+- **Additional attributes**
+
+    - `hidden`
+
+      Indicates that the item exists but shouldn't be displayed in a user-oriented browser. For more information, see [`hidden`](/windows/win32/Midl/hidden).
+
+    - `local`
+
+      Specifies that an interface or function isn't remote. For more information, see [`local`](/windows/win32/Midl/local).
+
+    - `restricted`
+
+      Specifies that a library, or member of a module, interface, or dispinterface can't be called arbitrarily. For more information, see [`restricted`](/windows/win32/Midl/restricted).
+
+    - `source`
+
+      Indicates that a member of a [`coclass`](/windows/win32/Midl/coclass), property, or method is a source of events. For a member of a `coclass`, this attribute means that the member is called rather than implemented. For more information, see [`source`](/windows/win32/Midl/source).
+
+## See also
+
+[Add a method wizard](adding-a-method-visual-cpp.md)\
+[Add an IDL MFC method wizard](../mfc/reference/add-idl-mfc-method-wizard.md)
diff --git a/docs/ide/media/add-interface-definition-library-method-wizard.png b/docs/ide/media/add-interface-definition-library-method-wizard.png
diff --git a/docs/ide/toc.yml b/docs/ide/toc.yml
@@ -78,6 +78,8 @@ items:
       href: ../ide/adding-a-member-variable-visual-cpp.md
     - name: Add a method
       href: ../ide/adding-a-method-visual-cpp.md
+    - name: Add an IDL method
+      href: ../ide/add-interface-definition-library-method-wizard.md 
     - name: Add a property
       href: ../ide/adding-a-property-visual-cpp.md
     - name: Add an IDL property
