Updated use of _DLL and UWP porting for 2411

Author: Colin Robertson

docs/atl/setting-up-a-static-link-to-the-registrar-code-cpp-only.md

@@ -1,21 +1,22 @@
 ---
-title: "Setting Up a Static Link to the Registrar Code (C++ Only)"
-ms.date: "11/04/2016"
+title: "Setting up a static link to the Registrar code (C++ only)"
+description: "How to statically link C++ code to the ATL Registrar code."
+ms.date: 09/03/2020
 helpviewer_keywords: ["statically linking to ATL Registrar code", "linking [C++], to ATL Registrar code"]
 ms.assetid: 835f5885-87a6-48fa-91e6-60988ee65538
 ---
-# Setting Up a Static Link to the Registrar Code (C++ Only)
+# Setting up a static link to the Registrar code (C++ Only)
 
 C++ clients can create a static link to the Registrar's code. Static linking of the Registrar's parser adds approximately 5K to a release build.
 
-The simplest way to set up static linking assumes you have specified [DECLARE_REGISTRY_RESOURCEID](reference/registry-macros.md#declare_registry_resourceid) in your object's declaration. (This is the default specification used by the ATL.)
+The simplest way to set up static linking assumes you have specified [`DECLARE_REGISTRY_RESOURCEID`](reference/registry-macros.md#declare_registry_resourceid) in your object's declaration. (It's the default specification used by the ATL.)
 
-## To create a static link using DECLARE_REGISTRY_RESOURCEID
+## To create a static link using `DECLARE_REGISTRY_RESOURCEID`
 
-1. Specify [/D](../build/reference/d-preprocessor-definitions.md) **\_ATL\_STATIC\_REGISTRY** instead of **/D \_ATL\_DLL**.
+1. Specify **`/D _ATL_STATIC_REGISTRY`** instead of **`/D _ATL_DLL`** on the CL command line. For more information, see [`/D`](../build/reference/d-preprocessor-definitions.md).
 
 1. Recompile.
 
 ## See also
 
-[Registry Component (Registrar)](../atl/atl-registry-component-registrar.md)
+[Registry component (Registrar)](../atl/atl-registry-component-registrar.md)

docs/build/importing-data-using-declspec-dllimport.md

@@ -1,16 +1,18 @@
 ---
-title: "Importing Data Using __declspec(dllimport)"
-ms.date: "11/04/2016"
+title: "Importing data using __declspec(dllimport)"
+description: "How to use __declspec(dllimport) to import DLL data."
+ms.date: 09/03/2020
 helpviewer_keywords: ["importing data [C++]", "dllimport attribute [C++], data imports", "__declspec(dllimport) keyword [C++]", "importing DLLs [C++], __declspec(dllimport)"]
 ms.assetid: 0ae70b39-87c7-4181-8be9-e786e0db60b0
 ---
-# Importing Data Using __declspec(dllimport)
+# Importing data using `__declspec(dllimport)`
 
 In the case of data, using **`__declspec(dllimport)`** is a convenience item that removes a layer of indirection. When you import data from a DLL, you still have to go through the import address table. Before **`__declspec(dllimport)`**, this meant you had to remember to do an extra level of indirection when accessing data exported from the DLL:
 
-```
+```C
 // project.h
-#ifdef _DLL   // If accessing the data from inside the DLL
+// Define PROJECT_EXPORTS when building your DLL
+#ifdef PROJECT_EXPORTS   // If accessing the data from inside the DLL
    ULONG ulDataInDll;
 
 #else         // If accessing the data from outside the DLL
@@ -20,7 +22,7 @@ In the case of data, using **`__declspec(dllimport)`** is a convenience item tha
 
 You would then export the data in your .DEF file:
 
-```
+```DEF
 // project.def
 LIBRARY project
 EXPORTS
@@ -29,7 +31,7 @@ EXPORTS
 
 and access it outside the DLL:
 
-```
+```C
 if (*ulDataInDll == 0L)
 {
    // Do stuff here
@@ -40,8 +42,15 @@ When you mark the data as **`__declspec(dllimport)`**, the compiler automaticall
 
 To export the data automatically from the DLL, use this declaration:
 
-```
-__declspec(dllexport) ULONG ulDataInDLL;
+```C
+// project.h
+// Define PROJECT_EXPORTS when building your DLL
+#ifdef PROJECT_EXPORTS   // If accessing the data from inside the DLL
+   __declspec(dllexport) ULONG ulDataInDLL;
+
+#else         // If accessing the data from outside the DLL
+   __declspec(dllimport) ULONG ulDataInDLL;
+#endif
 ```
 
 ## See also

docs/build/reference/c-cpp-prop-page.md

@@ -1,7 +1,7 @@
 ---
 title: "C/C++ Project Properties (Visual Studio)"
 description: "Reference guide to the Visual Studio Microsoft C/C++ project Property Pages properties."
-ms.date: 07/08/2020
+ms.date: 09/03/2020
 ms.topic: "article"
 ms.assetid: 16375038-4917-4bd0-9a2a-26343c1708b7
 ---
@@ -72,7 +72,7 @@ Treats compiler warnings as errors. For a new project, it may be best to use [`/
 
 ### Warning Version
 
-Hide warnings introduced after a specific version of the compiler. Sets [`/Wv:xx`\[`.yy`\[`.zzzzz`\]\]](wx-treat-linker-warnings-as-errors.md).
+Hide warnings introduced after a specific version of the compiler. Sets [`/Wv:xx[.yy[.zzzzz]]`](wx-treat-linker-warnings-as-errors.md).
 
 ### Diagnostics Format
 
@@ -96,7 +96,7 @@ Multi-processor Compilation.
 
 ### Optimization
 
-Select option for code optimization; choose Custom to use specific optimization options. Sets [/Od](od-disable-debug.md), [/O1, /O2](o-options-optimize-code.md).
+Select option for code optimization; choose Custom to use specific optimization options. Sets [`/Od`](od-disable-debug.md), [`/O1`, `/O2`](o-options-optimize-code.md).
 
 #### Choices
 
@@ -127,8 +127,8 @@ Whether to favor code size or code speed; 'Global Optimization' must be turned o
 
 #### Choices
 
-- **Favor small code** - Favor Small Code. Minimizes the size of EXEs and DLLs by instructing the compiler to favor size over speed.
-- **Favor fast code** - Favor Fast Code. Maximizes the speed of EXEs and DLLs by instructing the compiler to favor speed over size. (This value is the default.)
+- **Favor small code** - Minimizes the size of EXEs and DLLs by instructing the compiler to favor size over speed.
+- **Favor fast code** - Maximizes the speed of EXEs and DLLs by instructing the compiler to favor speed over size. (This value is the default.)
 - **Neither** - No size and speed optimization.
 
 ### Omit Frame Pointers
@@ -141,7 +141,7 @@ Enables memory space optimization when using fibers and thread local storage acc
 
 ### Whole Program Optimization
 
-Enables cross-module optimizations by delaying code generation to link time. Requires the linker option 'Link Time Code Generation'. Sets [`/GL`](gl-whole-program-optimization.md).
+Enables cross-module optimizations by delaying code generation to link time. Requires the linker option **Link Time Code Generation**. Sets [`/GL`](gl-whole-program-optimization.md).
 
 ## C/C++ Preprocessor Properties
 
@@ -171,7 +171,7 @@ Preprocess without #line directives.
 
 ### Keep Comments
 
-Suppresses comment strip from source code; requires that one of the 'Preprocessing' options be set. Sets [`/C`](c-preserve-comments-during-preprocessing.md).
+Suppresses comment strip from source code; requires setting at least one of the **Preprocessing** options. Sets [`/C`](c-preserve-comments-during-preprocessing.md).
 
 ## C/C++ Code Generation Properties
 
@@ -206,7 +206,7 @@ Enable basic runtime error checks, incompatible with any optimization type other
 
 - **Stack Frames** - Enables stack frame run-time error checking.
 - **Uninitialized variables** - Reports when a variable is used without having been initialized.
-- **Both (/RTC1, equiv. to /RTCsu)** - Equivalent of /RTCsu.
+- **Both (/RTC1, equiv. to /RTCsu)** - Equivalent of **`/RTCsu`**.
 - **Default** - Default runtime checks.
 
 ### Runtime Library
@@ -217,8 +217,8 @@ Specify runtime library for linking. Sets [`/MT`, `/MTd`, `/MD`, `/MDd`](md-mt-l
 
 - **Multi-threaded** - Causes your application to use the multithread, static version of the run-time library.
 - **Multi-threaded Debug** - Defines _DEBUG and _MT. This option also causes the compiler to place the library name *LIBCMTD.lib* into the *`.obj`* file so that the linker will use *LIBCMTD.lib* to resolve external symbols.
-- **Multi-threaded DLL** - Causes your application to use the multithread- and DLL-specific version of the run-time library. Defines _MT and _DLL and causes the compiler to place the library name *MSVCRT.lib* into the *`.obj`* file.
-- **Multi-threaded Debug DLL** - Defines _DEBUG, _MT, and _DLL and causes your application to use the debug multithread- and DLL-specific version of the run-time library. It also causes the compiler to place the library name *MSVCRTD.lib* into the *`.obj`* file.
+- **Multi-threaded DLL** - Causes your application to use the multithread- and DLL-specific version of the run-time library. Defines `_MT` and `_DLL` and causes the compiler to place the library name *MSVCRT.lib* into the *`.obj`* file.
+- **Multi-threaded Debug DLL** - Defines `_DEBUG`, `_MT`, and `_DLL` and causes your application to use the debug multithread- and DLL-specific version of the run-time library. It also causes the compiler to place the library name *MSVCRTD.lib* into the *`.obj`* file.
 
 ### Struct Member Alignment
 
@@ -253,15 +253,15 @@ Guard security check helps detect attempts to dispatch to illegal block of code.
 
 ### Enable Function-Level Linking
 
-Allows the compiler to package individual functions in the form of packaged functions (COMDATs). Required for edit and continue to work. Sets [/Gy](gy-enable-function-level-linking.md).
+Allows the compiler to package individual functions in the form of packaged functions (COMDATs). Required for edit and continue to work. Sets [`/Gy`](gy-enable-function-level-linking.md).
 
 ### Enable Parallel Code Generation
 
 Allows the compiler to generate parallel code for loops identified using `#pragma loop(hint_parallel[(n)])` when optimization is enabled.
 
 ### Enable Enhanced Instruction Set
 
-Enable use of instructions found on processors that support enhanced instruction sets. For example, the SSE, SSE2, AVX, and AVX2 enhancements to IA-32. And, the AVX and AVX2 enhancements to x64. Currently **`/arch:SSE`** and **`/arch:SSE2`** are only available when building for the x86 architecture. If no option is specified, the compiler will use instructions found on processors that support SSE2. Use of enhanced instructions can be disabled with **`/arch:IA32`**. For more information, see [`/arch (x86)`](arch-x86.md), [`/arch (x64)`](arch-x64.md) and [`/arch (ARM)`](arch-arm.md).
+Enable use of instructions found on processors that support enhanced instruction sets. For example, the SSE, SSE2, AVX, and AVX2 enhancements to IA-32. And, the AVX and AVX2 enhancements to x64. Currently **`/arch:SSE`** and **`/arch:SSE2`** are only available when building for the x86 architecture. If no option is specified, the compiler will use instructions found on processors that support SSE2. Use of enhanced instructions can be disabled with **`/arch:IA32`**. For more information, see [`/arch (x86)`](arch-x86.md), [`/arch (x64)`](arch-x64.md), and [`/arch (ARM)`](arch-arm.md).
 
 #### Choices
 
@@ -284,11 +284,11 @@ Sets the floating point model. Sets [`/fp:precise`, `/fp:strict`, `/fp:fast`](fp
 
 ### Enable Floating Point Exceptions
 
-Reliable floating-point exception model. Exceptions will be raised immediately after they're triggered. Sets [/fp:except](fp-specify-floating-point-behavior.md).
+Reliable floating-point exception model. Exceptions will be raised immediately after they're triggered. Sets [`/fp:except`](fp-specify-floating-point-behavior.md).
 
 ### Create Hotpatchable Image
 
-When hotpatching is on, the compiler ensures that first instruction of each function is two bytes, as required for hot patching. Sets [/hotpatch](hotpatch-create-hotpatchable-image.md).
+When hotpatching is on, the compiler ensures that first instruction of each function is two bytes, as required for hot patching. Sets [`/hotpatch`](hotpatch-create-hotpatchable-image.md).
 
 ### Spectre Mitigation
 
@@ -315,19 +315,19 @@ When specified, the type **`wchar_t`** becomes a native type that maps to **`__w
 
 ### Force Conformance in For Loop Scope
 
-Used to implement standard C++ behavior for the for statement loops with Microsoft extensions. Sets [`/Za`, `/Ze` (Disable language extensions](za-ze-disable-language-extensions.md). [`/Zc:forScope`](zc-forscope-force-conformance-in-for-loop-scope.md) is on by default.
+Implements standard C++ behavior for the `for` statement loops with Microsoft extensions. Sets [`/Za`, `/Ze` (Disable language extensions](za-ze-disable-language-extensions.md). [`/Zc:forScope`](zc-forscope-force-conformance-in-for-loop-scope.md) is on by default.
 
 ### Remove unreferenced code and data
 
-When specified, compiler no longer generates symbol information for unreferenced code and data.
+When specified, the compiler no longer generates symbol information for unreferenced code and data.
 
 ### Enforce type conversion rules
 
-Used to identify an rvalue reference type as the result of a cast operation per the C++11 standard.
+Used to identify an rvalue reference type as the result of a cast operation according to the C++11 standard.
 
 ### Enable Run-Time Type Information
 
-Adds code for checking C++ object types at run time (runtime type information). Sets [`/GR`, `/GR-`](gr-enable-run-time-type-information.md).
+Adds code for checking C++ object types at run time (*runtime type information*, or RTTI). Sets [`/GR`, `/GR-`](gr-enable-run-time-type-information.md).
 
 ### Open MP Support
 
@@ -356,8 +356,8 @@ Enables creation or use of a precompiled header during the build. Sets [`/Yc`](y
 
 #### Choices
 
-- **Create** - Instructs the compiler to create a precompiled header (.pch) file that represents the state of compilation at a certain point.
-- **Use** - Instructs the compiler to use an existing precompiled header (.pch) file in the current compilation.
+- **Create** - Instructs the compiler to create a precompiled header (*`.pch`*) file that represents the state of compilation at a certain point.
+- **Use** - Instructs the compiler to use an existing precompiled header (*`.pch`*) file in the current compilation.
 - **Not Using Precompiled Headers** - Not using precompiled headers.
 
 ### Precompiled Header File

docs/build/reference/u-u-undefine-symbols.md

@@ -1,6 +1,6 @@
 ---
 title: "/U, /u (Undefine symbols)"
-ms.date: "06/08/2020"
+ms.date: 09/03/2020
 f1_keywords: ["VC.Project.VCCLCompilerTool.UndefinePreprocessorDefinitions", "VC.Project.VCCLWCECompilerTool.UndefinePreprocessorDefinitions", "VC.Project.VCCLCompilerTool.UndefineAllPreprocessorDefinitions", "/u", "VC.Project.VCCLWCECompilerTool.UndefineAllPreprocessorDefinitions"]
 helpviewer_keywords: ["-U compiler option [C++]", "Undefine Symbols compiler option", "/U compiler option [C++]", "U compiler option [C++]"]
 ms.assetid: 7bc0474f-6d1f-419b-807d-0d8816763b2a
@@ -29,14 +29,14 @@ By default, the compiler may define a large number of Microsoft-specific symbols
 
 | Symbol | Function |
 |--|--|
-| `_CHAR_UNSIGNED` | Default char type is unsigned. Defined when the [**`/J`**](j-default-char-type-is-unsigned.md) option is specified. |
-| `_CPPRTTI` | Defined for code compiled with the [**`/GR`**](gr-enable-run-time-type-information.md) option. |
-| `_CPPUNWIND` | Defined for code compiled with the [**`/EHsc`**](eh-exception-handling-model.md) option. |
-| `_DLL` | Defined when the [**`/MD`**](md-mt-ld-use-run-time-library.md) option is specified. |
+| `_CHAR_UNSIGNED` | Default char type is unsigned. Defined when the [`/J`](j-default-char-type-is-unsigned.md) option is specified. |
+| `_CPPRTTI` | Defined for code compiled with the [`/GR`](gr-enable-run-time-type-information.md) option. |
+| `_CPPUNWIND` | Defined for code compiled with the [`/EHsc`](eh-exception-handling-model.md) option. |
+| `_DLL` | Defined when the [`/MD`](md-mt-ld-use-run-time-library.md) option is specified. |
 | `_M_IX86` | By default, defined to 600 for x86 targets. |
 | `_MSC_VER` | Defined as a unique integer value for each compiler version. For more information, see [Predefined macros](../../preprocessor/predefined-macros.md). |
 | `_WIN32` | Defined for WIN32 applications. Always defined. |
-| `_MT` | Defined when the [**`/MD`** or **`/MT`**](md-mt-ld-use-run-time-library.md) option is specified. |
+| `_MT` | Defined when the [`/MD`](md-mt-ld-use-run-time-library.md) or [`/MT`](md-mt-ld-use-run-time-library.md) option is specified. |
 
 For a complete list of Microsoft-specific predefined macros, see [Predefined macros](../../preprocessor/predefined-macros.md).