Merging changes synced from https://github.com/MicrosoftDocs/cpp-docs-pr (branch live)

Author: opbld16

.openpublishing.redirection.json

@@ -1,32 +1,50 @@
-# [Visual C++ in Visual Studio 2017](visual-cpp-in-visual-studio.md)
-# [What's New for Visual C++ in Visual Studio 2017](what-s-new-for-visual-cpp-in-visual-studio.md)
-# [Overview of C++ development in Visual Studio](overview-of-cpp-development.md)
-# Visual C++ Tutorial
+# [C++ in Visual Studio 2017](overview/visual-cpp-in-visual-studio.md)
+## [Overview of C++ development in Visual Studio](overview/overview-of-cpp-development.md)
+## [What's new for C++ in Visual Studio 2017](overview/what-s-new-for-visual-cpp-in-visual-studio.md)
+## [C++ conformance improvements in Visual Studio 2017](overview/cpp-conformance-improvements-2017.md)
+## [Microsoft C++ language conformance](overview/visual-cpp-language-conformance.md)
+## [Supported platforms](overview/supported-platforms-visual-cpp.md)
+## [Visual C++ Tools and Features in Visual Studio Editions](overview/visual-cpp-tools-and-features-in-visual-studio-editions.md)
+## [Samples](overview/visual-cpp-samples.md)
+## [Help and community](overview/visual-cpp-help-and-community.md)
+## [How to report a problem with the Visual C++ toolset](overview/how-to-report-a-problem-with-the-visual-cpp-toolset.md)
+# Visual C++ Tutorials
 ## [Install C++ support in Visual Studio](build/vscpp-step-0-installation.md)
 ## [Create a C++ console app project](build/vscpp-step-1-create.md)
 ## [Build and run a C++ console app project](build/vscpp-step-2-build.md)
-# [C++ conformance improvements in Visual Studio 2017](cpp-conformance-improvements-2017.md)
-## [Visual C++ Language Conformance](visual-cpp-language-conformance.md)
-# [Supported Platforms (Visual C++)](supported-platforms-visual-cpp.md)
-# [C Language](c-language/c-language-reference.md)
-# [C++ Language](cpp/cpp-language-reference.md)
-# [C/C++ Preprocessor](preprocessor/c-cpp-preprocessor-reference.md)
-# [C Runtime Library](c-runtime-library/c-run-time-library-reference.md)
-# [C++ Standard Library](standard-library/cpp-standard-library-reference.md)
 # [Projects and Build Systems](build/projects-and-build-systems-cpp.md)
 # [Writing and refactoring code](ide/writing-and-refactoring-code-cpp.md)
-# [Windows Development](windows/overview-of-windows-programming-in-cpp.md)
-# [Linux Development](linux/download-install-and-setup-the-linux-development-workload.md)
-# [Cloud and Web Programming in Visual C++](cloud/cloud-and-web-programming-in-visual-cpp.md)
-# [Parallel Programming](parallel/parallel-programming-in-visual-cpp.md)
-# [Data Access](data/data-access-in-cpp.md)
-# [Text and Strings](text/text-and-strings-in-visual-cpp.md)
-# [vcpkg: A Package Manager for C++](vcpkg.md)
-# [Port and Upgrade C++ Code](porting/visual-cpp-porting-and-upgrading-guide.md)
-# [Security Best Practices for C++](security/security-best-practices-for-cpp.md)
-## [Running as a Member of the Users Group](security/running-as-a-member-of-the-users-group.md)
-## [How User Account Control (UAC) Affects Your Application](security/how-user-account-control-uac-affects-your-application.md)
-## [C++ Developer Guidance for Speculative Execution Side Channels](security/developer-guidance-speculative-execution.md)
-# [Visual C++ Samples](visual-cpp-samples.md)
-# [Visual C++ Help and Community](visual-cpp-help-and-community.md)
-# [How to Report a Problem with the Visual C++ Toolset](how-to-report-a-problem-with-the-visual-cpp-toolset.md)
+# [Windows desktop development](windows/overview-of-windows-programming-in-cpp.md)
+# [UWP development](cppcx/universal-windows-apps-cpp.md)
+# [Game development](overview/game-development-cpp.md)
+# [Linux development](linux/download-install-and-setup-the-linux-development-workload.md)
+# [Cross-platform Mobile Development](/visualstudio/cross-platform/visual-cpp-for-cross-platform-mobile-development)
+# [.NET development with C++/CLI](dotnet/dotnet-programming-with-cpp-cli-visual-cpp.md)
+# [Cloud and Web programming](cloud/cloud-and-web-programming-in-visual-cpp.md)
+# [Port and upgrade C++ code](porting/visual-cpp-porting-and-upgrading-guide.md)
+# [Security best practices for C++](security/security-best-practices-for-cpp.md)
+## [Running as a member of the users group](security/running-as-a-member-of-the-users-group.md)
+## [How User Account Control (UAC) affects your application](security/how-user-account-control-uac-affects-your-application.md)
+## [C++ developer guidance for speculative execution side channels](security/developer-guidance-speculative-execution.md)
+# Reference
+## [Languages](overview/languages-cpp.md)
+### [C language](c-language/c-language-reference.md)
+### [C++ language](cpp/cpp-language-reference.md)
+### [C/C++ preprocessor](preprocessor/c-cpp-preprocessor-reference.md)
+### [Compiler intrinsics and assembly language](intrinsics/compiler-intrinsics-and-assembly-language.md)
+### [C Runtime Library](c-runtime-library/c-run-time-library-reference.md)
+### [Component extensions for .NET and UWP](extensions/component-extensions-for-runtime-platforms.md)
+### [C++ attributes for COM and .NET](windows/attributes/cpp-attributes-com-net.md)
+## [Libraries](overview/libraries-cpp.md)
+### [C Runtime Library](c-runtime-library/c-run-time-library-reference.md)
+### [C++ Standard Library](standard-library/cpp-standard-library-reference.md)
+### [SafeInt library](safeint/safeint-library.md)
+#### [SafeInt Class](safeint/safeint-class.md)
+#### [SafeInt Functions](safeint/safeint-functions.md)
+#### [SafeIntException Class](safeint/safeintexception-class.md)
+### [OpenMP](parallel/openmp/openmp-in-visual-cpp.md)
+### [MFC/ATL](mfc/mfc-and-atl.md)
+### [Parallel libraries](parallel/parallel-programming-in-visual-cpp.md)
+### [Data access libraries](data/data-access-in-cpp.md)
+
+

docs/TOC.md

@@ -33,7 +33,7 @@ Information about how to create output files for x64.
 
 ## Related Sections
 
-[Visual C++](../../visual-cpp-in-visual-studio.md)<br/>
+[Visual C++](../../overview/visual-cpp-in-visual-studio.md)<br/>
 Provides links to different areas of the Visual Studio and Visual C++ documentation.
 
 ## See also

docs/assembler/masm/microsoft-macro-assembler-reference.md

@@ -19,4 +19,4 @@ Class [CStringT](../atl-mfc-shared/reference/cstringt-class.md) is a template cl
 
 ## See also
 
-[CustomString sample](../visual-cpp-samples.md)
+[CustomString sample](../overview/visual-cpp-samples.md)

docs/atl-mfc-shared/memory-management-with-cstringt.md

@@ -1602,8 +1602,8 @@ BOOL TransparentBlt(CImage* pSrcImage, CImage* pDstImage,
 
 ## See also
 
-[MMXSwarm Sample](../../visual-cpp-samples.md)<br/>
-[SimpleImage Sample](../../visual-cpp-samples.md)<br/>
+[MMXSwarm Sample](../../overview/visual-cpp-samples.md)<br/>
+[SimpleImage Sample](../../overview/visual-cpp-samples.md)<br/>
 [Device-Independent Bitmaps](/windows/desktop/gdi/device-independent-bitmaps)<br/>
 [CreateDIBSection](/windows/desktop/api/wingdi/nf-wingdi-createdibsection)<br/>
 [ATL COM Desktop Components](../../atl/atl-com-desktop-components.md)<br/>

docs/atl-mfc-shared/reference/cimage-class.md

@@ -329,7 +329,7 @@ Use the unary operator to negate a point. For example, using the unary operator
 
 ## See also
 
-[MFC Sample MDI](../../visual-cpp-samples.md)<br/>
+[MFC Sample MDI](../../overview/visual-cpp-samples.md)<br/>
 [Hierarchy Chart](../../mfc/hierarchy-chart.md)<br/>
 [POINT Structure](/windows/desktop/api/windef/ns-windef-tagpoint)<br/>
 [CRect Class](../../atl-mfc-shared/reference/crect-class.md)<br/>

docs/atl-mfc-shared/reference/cpoint-class.md

@@ -213,7 +213,7 @@ The fourth operator, the unary minus, changes the sign of the `CSize` value. See
 
 ## See also
 
-[MFC Sample MDI](../../visual-cpp-samples.md)<br/>
+[MFC Sample MDI](../../overview/visual-cpp-samples.md)<br/>
 [Hierarchy Chart](../../mfc/hierarchy-chart.md)<br/>
 [CRect Class](../../atl-mfc-shared/reference/crect-class.md)<br/>
 [CPoint Class](../../atl-mfc-shared/reference/cpoint-class.md)

docs/atl-mfc-shared/reference/csize-class.md

@@ -80,7 +80,7 @@ Provides code for manipulating paths and URLs in the form of [CPathT](../atl/ref
 
 ## Related Sections
 
-[ATL Samples](../visual-cpp-samples.md)<br/>
+[ATL Samples](../overview/visual-cpp-samples.md)<br/>
 Provides descriptions of and links to the ATL sample programs.
 
 [Creating an ATL Project](../atl/reference/creating-an-atl-project.md)<br/>

docs/atl/active-template-library-atl-concepts.md

@@ -28,7 +28,7 @@ In either case, the Implement Connection Point Wizard uses a type library to do
 
    [!code-cpp[NVC_ATL_Windowing#82](../atl/codesnippet/cpp/adding-connection-points-to-an-object_2.idl)]
 
-   See the .idl file in the [Circ](../visual-cpp-samples.md) ATL sample for an example.
+   See the .idl file in the [Circ](../overview/visual-cpp-samples.md) ATL sample for an example.
 
 3. Use Class View to add methods and properties to the event interface. Right-click the class in Class View, point to **Add** on the shortcut menu, and click **Add Connection Point**.
 

docs/atl/adding-connection-points-to-an-object.md

@@ -102,13 +102,13 @@ The following diagram shows the class hierarchy for the CTraits classes.
 
 The following samples demonstrate the collection classes:
 
-- [MMXSwarm Sample](../visual-cpp-samples.md)
+- [MMXSwarm Sample](../overview/visual-cpp-samples.md)
 
-- [DynamicConsumer Sample](../visual-cpp-samples.md)
+- [DynamicConsumer Sample](../overview/visual-cpp-samples.md)
 
 - [UpdatePV Sample](https://github.com/Microsoft/VCSamples/tree/master/VC2010Samples/ATL/OLEDB/Provider/UPDATEPV)
 
-- [Marquee Sample](../visual-cpp-samples.md)
+- [Marquee Sample](../overview/visual-cpp-samples.md)
 
 ## See also
 

docs/atl/atl-collection-classes.md

@@ -30,7 +30,7 @@ An extended example that walks you through the implementation of a C++ Standard
 [ATL](../atl/active-template-library-atl-concepts.md)<br/>
 Provides links to conceptual topics on how to program using the Active Template Library.
 
-[ATLCollections Sample](../visual-cpp-samples.md)<br/>
+[ATLCollections Sample](../overview/visual-cpp-samples.md)<br/>
 A sample that demonstrates the use of `ICollectionOnSTLImpl` and `CComEnumOnSTL`, and the implementation of custom copy policy classes.
 
 ## See also

docs/atl/atl-collections-and-enumerators.md

@@ -39,7 +39,7 @@ Provides topics on how to program using the Active Template Library (ATL).
 [ATL Tutorial](../atl/active-template-library-atl-tutorial.md)<br/>
 Leads you through the creation of a control and demonstrates some ATL fundamentals in the process.
 
-[ATL Samples](../visual-cpp-samples.md)<br/>
+[ATL Samples](../overview/visual-cpp-samples.md)<br/>
 Sample code that shows how to use ATL to write COM objects.
 
 [OLE DB Templates](../data/oledb/ole-db-templates.md)<br/>

docs/atl/atl-com-desktop-components.md

@@ -24,7 +24,7 @@ Lists the steps for implementing property pages, including methods to override.
 
 ## Related Sections
 
-[ATLPages Sample](../visual-cpp-samples.md)<br/>
+[ATLPages Sample](../overview/visual-cpp-samples.md)<br/>
 The sample abstract for the ATLPages sample, which implements a property page using `IPropertyPageImpl`.
 
 [ATL](../atl/active-template-library-atl-concepts.md)<br/>

docs/atl/atl-com-property-pages.md

@@ -51,7 +51,7 @@ ATL provides two copy policy classes in the form of the `_Copy` and `_CopyInterf
 
 ## Custom Implementations
 
-Typically, you'll need to define your own copy policy classes for heterogeneous copying (that is, conversion between data types). For some examples of custom copy policy classes, look at the files VCUE_Copy.h and VCUE_CopyString.h in the [ATLCollections](../visual-cpp-samples.md) sample. These files contain two template copy policy classes, `GenericCopy` and `MapCopy`, plus a number of specializations of `GenericCopy` for different data types.
+Typically, you'll need to define your own copy policy classes for heterogeneous copying (that is, conversion between data types). For some examples of custom copy policy classes, look at the files VCUE_Copy.h and VCUE_CopyString.h in the [ATLCollections](../overview/visual-cpp-samples.md) sample. These files contain two template copy policy classes, `GenericCopy` and `MapCopy`, plus a number of specializations of `GenericCopy` for different data types.
 
 ### GenericCopy
 
@@ -70,4 +70,4 @@ VCUE_Copy.h also contains the following specializations of this class: `GenericC
 ## See also
 
 [Implementing a C++ Standard Library-Based Collection](../atl/implementing-an-stl-based-collection.md)<br/>
-[ATLCollections Sample](../visual-cpp-samples.md)
+[ATLCollections Sample](../overview/visual-cpp-samples.md)

docs/atl/atl-copy-policy-classes.md

@@ -21,7 +21,7 @@ The following classes provide general support for ATL controls:
 
 ## Sample Program
 
-[ATLFire](../visual-cpp-samples.md)
+[ATLFire](../overview/visual-cpp-samples.md)
 
 ## Related Articles
 

docs/atl/controls-general-support-classes.md

@@ -8,7 +8,7 @@ ms.assetid: c30b67fe-ce08-4249-ae29-f3060fa8d61e
 
 This example shows how to build a property page that displays (and allows you to change) properties of the [Document Classes](../mfc/document-classes.md) interface.
 
-The example is based on the [ATLPages sample](../visual-cpp-samples.md).
+The example is based on the [ATLPages sample](../overview/visual-cpp-samples.md).
 
 To complete this example, you will:
 
@@ -157,4 +157,4 @@ When you run this macro, the property page will be displayed showing the file na
 ## See also
 
 [Property Pages](../atl/atl-com-property-pages.md)<br/>
-[ATLPages Sample](../visual-cpp-samples.md)
+[ATLPages Sample](../overview/visual-cpp-samples.md)

docs/atl/example-implementing-a-property-page.md

@@ -8,7 +8,7 @@ ms.assetid: 6d49f819-1957-4813-b074-3f12c494d8ca
 
 ATL provides the `ICollectionOnSTLImpl` interface to enable you to quickly implement C++ Standard Library-based collection interfaces on your objects. To understand how this class works, you will work through a simple example (below) that uses this class to implement a read-only collection aimed at Automation clients.
 
-The sample code is from the [ATLCollections sample](../visual-cpp-samples.md).
+The sample code is from the [ATLCollections sample](../overview/visual-cpp-samples.md).
 
 To complete this procedure, you will:
 
@@ -68,7 +68,7 @@ The typedefs you have created so far provide all the information you need to cre
 
 [!code-cpp[NVC_ATL_COM#26](../atl/codesnippet/cpp/implementing-an-stl-based-collection_3.h)]
 
-In this example, you can use the custom `GenericCopy` class defined in VCUE_Copy.h and VCUE_CopyString.h from the [ATLCollections](../visual-cpp-samples.md) sample. You can use this class in other code, but you may need to define further specializations of `GenericCopy` to support data types used in your own collections. For more information, see [ATL Copy Policy Classes](../atl/atl-copy-policy-classes.md).
+In this example, you can use the custom `GenericCopy` class defined in VCUE_Copy.h and VCUE_CopyString.h from the [ATLCollections](../overview/visual-cpp-samples.md) sample. You can use this class in other code, but you may need to define further specializations of `GenericCopy` to support data types used in your own collections. For more information, see [ATL Copy Policy Classes](../atl/atl-copy-policy-classes.md).
 
 ##  <a name="vcconenumeration_and_collection"></a> Creating Typedefs for Enumeration and Collection
 
@@ -95,5 +95,5 @@ Now, you can test the code with the client of your choice.
 ## See also
 
 [Collections and Enumerators](../atl/atl-collections-and-enumerators.md)<br/>
-[ATLCollections Sample](../visual-cpp-samples.md)<br/>
+[ATLCollections Sample](../overview/visual-cpp-samples.md)<br/>
 [ATL Copy Policy Classes](../atl/atl-copy-policy-classes.md)

docs/atl/implementing-an-stl-based-collection.md

@@ -39,4 +39,4 @@ For an example property page implementation, see [Example: Implementing a Proper
 ## See also
 
 [Property Pages](../atl/atl-com-property-pages.md)<br/>
-[ATLPages Sample](../visual-cpp-samples.md)
+[ATLPages Sample](../overview/visual-cpp-samples.md)

docs/atl/implementing-property-pages.md

@@ -1127,6 +1127,6 @@ The primary group is the default group for new objects created while this access
 
 ## See also
 
-[ATLSecurity Sample](../../visual-cpp-samples.md)<br/>
+[ATLSecurity Sample](../../overview/visual-cpp-samples.md)<br/>
 [Access Tokens](/windows/desktop/SecAuthZ/access-tokens)<br/>
 [Class Overview](../../atl/atl-class-overview.md)

docs/atl/reference/caccesstoken-class.md

@@ -522,9 +522,9 @@ Replaces the value of the element pointed to by the index. If *iElement* is larg
 
 ## See also
 
-[MMXSwarm Sample](../../visual-cpp-samples.md)<br/>
-[DynamicConsumer Sample](../../visual-cpp-samples.md)<br/>
-[UpdatePV Sample](../../visual-cpp-samples.md)<br/>
-[Marquee Sample](../../visual-cpp-samples.md)<br/>
+[MMXSwarm Sample](../../overview/visual-cpp-samples.md)<br/>
+[DynamicConsumer Sample](../../overview/visual-cpp-samples.md)<br/>
+[UpdatePV Sample](../../overview/visual-cpp-samples.md)<br/>
+[Marquee Sample](../../overview/visual-cpp-samples.md)<br/>
 [CArray Class](../../mfc/reference/carray-class.md)<br/>
 [Class Overview](../../atl/atl-class-overview.md)

docs/atl/reference/catlarray-class.md

@@ -329,7 +329,7 @@ This method can be overridden. If overriding [CAtlExeModuleT::PreMessageLoop](#p
 
 ## See also
 
-[ATLDuck Sample](../../visual-cpp-samples.md)<br/>
+[ATLDuck Sample](../../overview/visual-cpp-samples.md)<br/>
 [CAtlModuleT Class](../../atl/reference/catlmodulet-class.md)<br/>
 [CAtlDllModuleT Class](../../atl/reference/catldllmodulet-class.md)<br/>
 [Class Overview](../../atl/atl-class-overview.md)

docs/atl/reference/catlexemodulet-class.md

@@ -427,6 +427,6 @@ The first three forms call [WriteFile](/windows/desktop/api/fileapi/nf-fileapi-w
 
 ## See also
 
-[Marquee Sample](../../visual-cpp-samples.md)<br/>
+[Marquee Sample](../../overview/visual-cpp-samples.md)<br/>
 [Class Overview](../../atl/atl-class-overview.md)<br/>
 [CHandle Class](../../atl/reference/chandle-class.md)

docs/atl/reference/catlfile-class.md

@@ -743,6 +743,6 @@ The value element type.
 
 ## See also
 
-[Marquee Sample](../../visual-cpp-samples.md)<br/>
+[Marquee Sample](../../overview/visual-cpp-samples.md)<br/>
 [UpdatePV Sample](https://github.com/Microsoft/VCSamples/tree/master/VC2010Samples/ATL/OLEDB/Provider/UPDATEPV)<br/>
 [Class Overview](../../atl/atl-class-overview.md)

docs/atl/reference/catlmap-class.md

@@ -124,6 +124,6 @@ If this method is called for the purposes that include the reversion of an imper
 
 ## See also
 
-[ATLSecurity Sample](../../visual-cpp-samples.md)<br/>
+[ATLSecurity Sample](../../overview/visual-cpp-samples.md)<br/>
 [Access Tokens](/windows/desktop/SecAuthZ/access-tokens)<br/>
 [Class Overview](../../atl/atl-class-overview.md)

docs/atl/reference/cautorevertimpersonation-class.md

@@ -349,7 +349,7 @@ The external `IDocHostUIHandlerDispatch` interface is used by controls that quer
 
 ## See also
 
-[ATLCON Sample](../../visual-cpp-samples.md)<br/>
+[ATLCON Sample](../../overview/visual-cpp-samples.md)<br/>
 [CWindow Class](../../atl/reference/cwindow-class.md)<br/>
 [Composite Control Fundamentals](../../atl/atl-composite-control-fundamentals.md)<br/>
 [Class Overview](../../atl/atl-class-overview.md)<br/>

docs/atl/reference/caxwindow-class.md

@@ -70,7 +70,7 @@ Specifies the bind flags that are returned by [GetBindInfo](#getbindinfo). The d
 
 The `CBindStatusCallback` class implements the `IBindStatusCallback` interface. `IBindStatusCallback` must be implemented by your application so it can receive notifications from an asynchronous data transfer. The asynchronous moniker provided by the system uses `IBindStatusCallback` methods to send and receive information about the asynchronous data transfer to and from your object.
 
-Typically, the `CBindStatusCallback` object is associated with a specific bind operation. For example, in the [ASYNC](../../visual-cpp-samples.md) sample, when you set the URL property, it creates a `CBindStatusCallback` object in the call to `Download`:
+Typically, the `CBindStatusCallback` object is associated with a specific bind operation. For example, in the [ASYNC](../../overview/visual-cpp-samples.md) sample, when you set the URL property, it creates a `CBindStatusCallback` object in the call to `Download`:
 
 [!code-cpp[NVC_ATL_Windowing#86](../../atl/codesnippet/cpp/cbindstatuscallback-class_1.h)]
 
@@ -497,7 +497,7 @@ void Function_Name(
     DWORD dwSize);
 ```
 
-In the following example (taken from the [ASYNC](../../visual-cpp-samples.md) sample), the function `OnData` writes the received data into a text box.
+In the following example (taken from the [ASYNC](../../overview/visual-cpp-samples.md) sample), the function `OnData` writes the received data into a text box.
 
 ### Example
 

docs/atl/reference/cbindstatuscallback-class.md

@@ -52,7 +52,7 @@ The base class that implements windowing functions. Defaults to [CWindowImpl](..
 
 For more information about creating a control, see the [ATL Tutorial](../../atl/active-template-library-atl-tutorial.md). For more information about the ATL Project Wizard, see the article [Creating an ATL Project](../../atl/reference/creating-an-atl-project.md).
 
-For a demonstration of `CComControl` methods and data members, see the [CIRC](../../visual-cpp-samples.md) sample.
+For a demonstration of `CComControl` methods and data members, see the [CIRC](../../overview/visual-cpp-samples.md) sample.
 
 ## Inheritance Hierarchy