4/18/2022 AM Publish (MicrosoftDocs#4229)

Taojunshen · Steve Wishnousky · rachana-satao · web-flow · commit 2cce586284d0 · 2022-04-19T01:42:12.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 * New article - IDL MFC property wizard * 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 for new article * 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 * Final Update- See also section * edit pass * edit pass * more cleanup * typo * small edit * Final update * edit pass * edit pass * formatting for scannability * acrolinx * one more try at spacing * final update * VMCS -> VMXON According to the intel IA32 development manual (Volume 3 C3 23.7): "Before executing VMXON, software should allocate a naturally aligned 4-KByte region of memory that a logical processor may use to support VMX operation. This region is called the VMXON region." * edit and add links * fix links * add code example * click->tick * Update date, link to Intel docs * Another go at updating the description * Fix stray double-quote * Address issue in DD PR 1393452 * add /interface and /internal-partition - draft (MicrosoftDocs#4227) * add /interface and /internal-partition - draft * add example * fix formatting * update text regarding example * tech review * link updates * fix switch name and link * edits * reorder version info * cleanup * add /tp flag * fix command line Co-authored-by: TylerMSFT <Tyler.Whitney@microsoft.com> 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> Co-authored-by: Colin Cooper <72402153+v-ccolin@users.noreply.github.com> Co-authored-by: krispy <monstertyo@gmail.com> Co-authored-by: PRMerger8 <prmrgr8@microsoft.com> Co-authored-by: PRMerger10 <prmrgr10@microsoft.com>
diff --git a/docs/build/reference/compiler-options-listed-alphabetically.md b/docs/build/reference/compiler-options-listed-alphabetically.md
@@ -1,7 +1,7 @@
 ---
 title: "Compiler options listed alphabetically"
 description: "Reference listing in alphabetical order of the Microsoft C/C++ compiler command-line options."
-ms.date: 12/15/2021
+ms.date: 04/15/2022
 helpviewer_keywords: ["compiler options, C++"]
 ---
 # Compiler options listed alphabetically
@@ -112,6 +112,8 @@ This table contains an alphabetical list of compiler options. For a list of comp
 | [`/hotpatch`](hotpatch-create-hotpatchable-image.md) | Creates a hotpatchable image. |
 | [`/I<dir>`](i-additional-include-directories.md) | Searches a directory for include files. |
 | **`/ifcOutput`** | Specify output file or directory for *`.ifc`* files. |
+| [`/interface`](interface.md) | Treat the input file as a module interface unit. |
+| [`/internalPartition`](internal-partition.md) | Treat the input file as an internal partition unit. |
 | [`/J`](j-default-char-type-is-unsigned.md) | Changes the default **`char`** type. |
 | [`/JMC`](jmc.md) | Supports native C++ Just My Code debugging. |
 | [`/kernel`](kernel-create-kernel-mode-binary.md) | The compiler and linker will create a binary that can be executed in the Windows kernel. |
@@ -161,7 +163,7 @@ This table contains an alphabetical list of compiler options. For a list of comp
 | [`/RTCs`](rtc-run-time-error-checks.md) | Enable stack frame runtime checks. |
 | [`/RTCu`](rtc-run-time-error-checks.md) | Enables uninitialized local usage checks. |
 | [`/scanDependencies`](scandependencies.md) | List module dependencies in C++ Standard JSON form. |
-| [`/sdl`](sdl-enable-additional-security-checks.md) | Enable additional security features and warnings. |
+| [`/sdl`](sdl-enable-additional-security-checks.md) | Enable more security features and warnings. |
 | [`/showIncludes`](showincludes-list-include-files.md) | Displays a list of all include files during compilation. |
 | [`/source-charset`](source-charset-set-source-character-set.md) | Set source character set. |
 | [`/sourceDependencies`](sourcedependencies.md) | List all source-level dependencies. |
diff --git a/docs/build/reference/compiler-options-listed-by-category.md b/docs/build/reference/compiler-options-listed-by-category.md
@@ -1,7 +1,7 @@
 ---
 title: "Compiler Options Listed by Category"
 description: "Reference listing by category of the Microsoft C/C++ compiler command-line options."
-ms.date: 12/15/2021
+ms.date: 04/15/2022
 helpviewer_keywords: ["compiler options, C++"]
 ms.assetid: c4750dcf-dba0-4229-99b6-45cdecc11729
 ---
@@ -130,14 +130,16 @@ This article contains a categorical list of compiler options. For an alphabetica
 | [`/u`](u-u-undefine-symbols.md) | Removes all predefined macros. |
 | [`/X`](x-ignore-standard-include-paths.md) | Ignores the standard include directory. |
 
-## Header units
+## Header units/modules
 
 | Option | Purpose |
 |--|--|
 | [`/exportHeader`](module-exportheader.md) | Create the header units files (*`.ifc`*) specified by the input arguments. |
 | [`/headerUnit`](headerunit.md) | Specify where to find the header unit file (*`.ifc`*) for the specified header. |
 | [`/headerName`](headername.md) | Build a header unit from the specified header. |
 | **`/ifcOutput`** | Specify output file or directory for *`.ifc`* files. |
+| [`/interface`](interface.md) | Treat the input file as a module interface unit. |
+| [`/internalPartition`](internal-partition.md) | Treat the input file as an internal partition unit. |
 | [`/reference`](module-reference.md) | Use named module IFC. |
 | [`/scanDependencies`](scandependencies.md) | List module and header unit dependencies in C++ Standard JSON form. |
 | [`/sourceDependencies`](sourcedependencies.md) | List all source-level dependencies. |
@@ -274,7 +276,7 @@ This article contains a categorical list of compiler options. For an alphabetica
 | [`/external:templates[-]`](external-external-headers-diagnostics.md) | Evaluate warning level across template instantiation chain. |
 | [`/external:W<n>`](external-external-headers-diagnostics.md) | Set warning level for external headers. |
 | [`/options:strict`](options-strict.md) | Unrecognized compiler options are errors. |
-| [`/sdl`](sdl-enable-additional-security-checks.md) | Enable additional security features and warnings. |
+| [`/sdl`](sdl-enable-additional-security-checks.md) | Enable more security features and warnings. |
 | [`/w`](compiler-option-warning-level.md) | Disable all warnings. |
 | [`/W0`, `/W1`, `/W2`, `/W3`, `/W4`](compiler-option-warning-level.md) | Set output warning level. |
 | [`/w1<n>`, `/w2<n>`, `/w3<n>`, `/w4<n>`](compiler-option-warning-level.md) | Set warning level for the specified warning. |
diff --git a/docs/build/reference/interface.md b/docs/build/reference/interface.md
@@ -0,0 +1,38 @@
+---
+title: "/interface"
+description: "Use the /interface compiler option to treat the input file as a module interface unit."
+ms.date: 04/15/2022
+author: "tylermsft"
+ms.author: "twhitney"
+f1_keywords: ["/interface", "VC.Project.VCCLCompilerTool.Interface"]
+helpviewer_keywords: ["/interface", "Translate include directives into import directives"]
+---
+# `/interface`
+
+This switch instructs the compiler to treat the input file on the command line as a module interface unit.
+
+## Syntax
+
+> **`/interface`** *`filename`*
+
+## Remarks
+
+Use this switch when a module interface has a different extension than `.ixx`.
+
+In the following example, the module interface has a `.cppm` extension instead of `.ixx`, so the `/interface` switch is used to compile it as a module interface:
+
+```bash
+cl /c /std:c++latest /interface /TP my-module.cppm
+```
+
+The compiler derives the name for the generated `.ifc` file from the module interface name. For example, given a module name `MyModule` defined in `my-module.cppm`, the generated `.ifc` will be named `MyModule.ifc`.
+
+This switch must be used in with the [`/TP` (Specify source file type)](tc-tp-tc-tp-specify-source-file-type.md) compiler flag.
+
+**`/interface`** is available in Visual Studio 2019 version 16.10, or later.\
+**`/interface`** requires [/std:c++20](std-specify-language-standard-version.md) or later.
+
+## See also
+
+[Overview of modules in C++](../../cpp/modules-cpp.md)\
+[Using C++ Modules in MSVC from the Command Line](https://devblogs.microsoft.com/cppblog/using-cpp-modules-in-msvc-from-the-command-line-part-1/)
diff --git a/docs/build/reference/internal-partition.md b/docs/build/reference/internal-partition.md
@@ -0,0 +1,55 @@
+---
+title: "/internalPartition"
+description: "Use the /internalPartition compiler option to treat the input file as an internal partition unit."
+ms.date: 04/15/2022
+author: "tylermsft"
+ms.author: "twhitney"
+f1_keywords: ["/internalPartition", "VC.Project.VCCLCompilerTool.Interface"]
+helpviewer_keywords: ["/internalPartition", "Translate include directives into import directives"]
+---
+# `/internalPartition`
+
+Use this switch to treat the input file on the command line as an [internal partition unit](http://eel.is/c%2B%2Bdraft/module#unit-4.3).
+
+## Syntax
+
+> **`/internalPartition`** *`filename`*
+
+## Remarks
+
+The following example demonstrates using the `/internalPartition` switch:
+
+`m-internals.cpp`:
+
+```cpp
+module m:internals;
+
+void internalFunc() {} // cannot have `export` since this is an internal partition
+```
+
+`m.ixx`:
+
+```cpp
+export module m;
+import :internals; // Cannot export this partition.
+
+export
+void wrapper() { internalFunc(); }
+```
+
+To compile this interface:
+
+```bash
+cl /std:c++latest /internalPartition /c m-internals.cpp
+```
+
+This switch can't be used with the [`/interface`](interface.md) compiler switch.
+
+**`/internalPartition`** is available in Visual Studio 2019 version 16.10, or later.\
+**`/internalPartition`** requires [/std:c++20](std-specify-language-standard-version.md) or later.
+
+## See also
+
+[Overview of modules in C++](../../cpp/modules-cpp.md)\
+[Using C++ Modules in MSVC from the Command Line](https://devblogs.microsoft.com/cppblog/using-cpp-modules-in-msvc-from-the-command-line-part-1/)\
+[C++ Modules conformance improvements with MSVC in Visual Studio 2019 16.5](https://devblogs.microsoft.com/cppblog/c-modules-conformance-improvements-with-msvc-in-visual-studio-2019-16-5/#module-partitions)
diff --git a/docs/build/toc.yml b/docs/build/toc.yml
@@ -621,6 +621,10 @@ items:
                   href: ../build/reference/hotpatch-create-hotpatchable-image.md
                 - name: /I (Additional include directories)
                   href: ../build/reference/i-additional-include-directories.md
+                - name: /interface (treat input file as a module interface unit)
+                  href: ../build/reference/interface.md
+                - name: /internalPartition (treat the input file as an internal partition unit.)
+                  href: ../build/reference/internal-partition.md
                 - name: /J (Default char type is unsigned)
                   href: ../build/reference/j-default-char-type-is-unsigned.md
                 - name: /JMC (Just My Code debugging)
diff --git a/docs/extensions/interface-class-cpp-component-extensions.md b/docs/extensions/interface-class-cpp-component-extensions.md
@@ -1,17 +1,17 @@
 ---
-description: "Learn more about: interface class  (C++/CLI and C++/CX)"
+description: "Learn more about: interface class (C++/CLI and C++/CX)"
 title: "interface class  (C++/CLI and C++/CX)"
-ms.date: "10/12/2018"
+ms.date: 04/15/2022
 ms.topic: "reference"
-f1_keywords: ["interface_CPP"]
+f1_keywords: ["interface_CPP", "interface class", "interface class_CPP"]
 helpviewer_keywords: ["interface class keyword", "interface struct keyword"]
 ms.assetid: 3ccea701-f50b-4da7-ad6b-f0ee1203e2b9
 ---
-# interface class  (C++/CLI and C++/CX)
+# `interface class`  (C++/CLI and C++/CX)
 
-Declares an interface.  For information on native interfaces, see [__interface](../cpp/interface.md).
+Declares an interface.  For information on native interfaces, see [`__interface`](../cpp/interface.md).
 
-## All Runtimes
+## All runtimes
 
 ### Syntax
 
@@ -22,39 +22,39 @@ interface_access interface struct name : inherit_access base_interface {};
 
 ### Parameters
 
-*interface_access*<br/>
-The accessibility of an interface outside the assembly.  Possible values are **`public`** and **`private`**.  **`private`** is the default. Nested interfaces cannot have an *interface_access* specifier.
+*`interface_access`*\
+The accessibility of an interface outside the assembly.  Possible values are **`public`** and **`private`**.  **`private`** is the default. Nested interfaces can't have an *`interface_access`* specifier.
 
-*name*<br/>
+*`name`*\
 The name of the interface.
 
-*inherit_access*<br/>
-The accessibility of *base_interface*.  The only permitted accessibility for a base interface is **`public`** (the default).
+*`inherit_access`*\
+The accessibility of *`base_interface`*.  The only permitted accessibility for a base interface is **`public`** (the default).
 
-*base_interface*<br/>
-(Optional) A base interface for interface *name*.
+*`base_interface`*\
+(Optional) A base interface for interface *`name`*.
 
 ### Remarks
 
-**interface struct** is equivalent to **interface class**.
+**`interface struct`** is equivalent to **`interface class`**.
 
 An interface can contain declarations for functions, events, and properties.  All interface members have public accessibility. An interface can also contain static data members, functions, events, and properties, and these static members must be defined in the interface.
 
-An interface defines how a class may be implemented. An interface is not a class and classes can only implement interfaces. When a class defines a function declared in an interface, the function is implemented, not overridden. Therefore, name lookup does not include interface members.
+An interface defines how a class may be implemented. An interface isn't a class and classes can only implement interfaces. When a class defines a function declared in an interface, the function is implemented, not overridden. Therefore, name lookup doesn't include interface members.
 
-A class or struct that derives from an interface must implement all members of the interface. When implementing interface *name* you must also implement the interfaces in the `base_interface` list.
+A `class` or `struct` that derives from an interface must implement all members of the interface. When implementing interface *`name`*, you must also implement the interfaces in the *`base_interface`* list.
 
 For more information, see:
 
-- [Interface Static Constructor](../dotnet/how-to-define-an-interface-static-constructor-cpp-cli.md)
+- [Interface static constructor](../dotnet/how-to-define-an-interface-static-constructor-cpp-cli.md)
 
-- [Generic Interfaces (C++/CLI)](generic-interfaces-visual-cpp.md)
+- [Generic interfaces (C++/CLI)](generic-interfaces-visual-cpp.md)
 
 For information on other CLR types, see [Classes and Structs](classes-and-structs-cpp-component-extensions.md).
 
-You can detect at compile time if a type is an interface with `__is_interface_class(type)`. For more information, see [Compiler Support for Type Traits](compiler-support-for-type-traits-cpp-component-extensions.md).
+You can detect at compile time if a type is an interface with `__is_interface_class(type)`. For more information, see [Compiler support for type traits](compiler-support-for-type-traits-cpp-component-extensions.md).
 
-In the development environment, you can get F1 help on these keywords by highlighting the keyword, (**`interface class`**, for example) and pressing F1.
+In the development environment, you can get F1 help on these keywords by highlighting the keyword (for example, **`interface class`**) and pressing **F1**.
 
 ## Windows Runtime
 
