Merge pull request MicrosoftDocs#98 from Microsoft/master

Merge to live

Author: ghogen

docs/TOC.md

@@ -1,6 +1,6 @@
-# [Visual C++ in Visual Studio 2017 RC](top/visual-cpp-in-visual-studio.md)
-# [What's New for Visual C++ in Visual Studio 2017 RC](top/what-s-new-for-visual-cpp-in-visual-studio.md)
-# [Supported Platforms (Visual C++)](top/supported-platforms-visual-cpp.md)
+# [Visual C++ in Visual Studio 2017 RC](visual-cpp-in-visual-studio.md)
+# [What's New for Visual C++ in Visual Studio 2017 RC](what-s-new-for-visual-cpp-in-visual-studio.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)
@@ -9,17 +9,17 @@
 # [Windows Development](windows/overview-of-windows-programming-in-cpp.md)
 # [Linux Development](linux/download-install-and-setup-the-linux-development-workload.md)
 # [.NET Development with C++/CLI](dotnet/dotnet-programming-with-cpp-cli-visual-cpp.md)
-# [Cloud and Web Programming in Visual C++](top/cloud-and-web-programming-in-visual-cpp.md)
-## [C++ REST SDK (Codename "Casablanca")](top/cpp-rest-sdk-codename-casablanca.md)
+# [Cloud and Web Programming in Visual C++](cloud/cloud-and-web-programming-in-visual-cpp.md)
+## [C++ REST SDK (Codename "Casablanca")](cloud/cpp-rest-sdk-codename-casablanca.md)
 # [Parallel Programming](parallel/parallel-programming-in-visual-cpp.md)
 # [Data Access](data/data-access-programming-mfc-atl.md)
 # [Text and Strings](text/text-and-strings-in-visual-cpp.md)
 # [Using the Visual Studio IDE for C++](ide/ide-and-tools-for-visual-cpp-development.md)
 # [Compilers and Build Tools](build/building-c-cpp-programs.md)
 # [Porting and Upgrading Visual C++ Code](porting/visual-cpp-porting-and-upgrading-guide.md)
-# [Security Best Practices for C++](top/security-best-practices-for-cpp.md)
-## [Running as a Member of the Users Group](top/running-as-a-member-of-the-users-group.md)
-## [How User Account Control (UAC) Affects Your Application](top/how-user-account-control-uac-affects-your-application.md)
-# [Visual C++ Samples](top/visual-cpp-samples.md)
-# [Visual C++ Help and Community](top/visual-cpp-help-and-community.md)
-# [How to Report a Problem with the Visual C++ Toolset](top/how-to-report-a-problem-with-the-visual-cpp-toolset.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)
+# [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)

docs/_breadcrumb/toc.yml

@@ -117,4 +117,10 @@
         topicHref: /cpp/porting/porting-and-upgrading-guide
       - name: Text and Strings
         tocHref: /cpp/text/
-        topicHref: /cpp/text/text-and-strings
+        topicHref: /cpp/text/text-and-strings
+      - name: Security
+        tocHref: /cpp/security
+        topicHref: /cpp/security/security-best-practices-for-cpp
+      - name: Cloud and Web
+        tocHref: /cpp/cloud
+        topicHref: /cpp/cloud/cloud-and-web-programming-in-visual-cpp

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

@@ -61,7 +61,7 @@ The Microsoft Macro Assembler (MASM) provides several advantages over inline ass
  Information about how to create output files for [!INCLUDE[vcprx64](../../assembler/inline/includes/vcprx64_md.md)].  
 
 ## Related Sections  
- [Visual C++](../../visual-cpp-in-visual-studio.md)  
+ [Visual C++](../../top/visual-cpp-in-visual-studio.md)  
  Provides links to different areas of the Visual Studio and Visual C++ documentation.  
 
  [Visual C++ Reference](http://msdn.microsoft.com/en-us/1ba03b5c-8229-4f63-b08c-6c12141d6ab1)  

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

@@ -54,5 +54,5 @@ Class [CStringT](../atl-mfc-shared/reference/cstringt-class.md) is a template cl
 -   [CFixedStringT: An Example of a Custom String Manager](../atl-mfc-shared/cfixedstringt-example-of-a-custom-string-manager.md)  
 
 ## See Also  
- [CustomString sample](../top/visual-cpp-samples.md)
+ [CustomString sample](../visual-cpp-samples.md)
 

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

@@ -1504,8 +1504,8 @@ BOOL TransparentBlt(CImage* pSrcImage, CImage* pDstImage, int xDest, int yDest,
 
 
 ## See Also  
- [MMXSwarm Sample](../../top/visual-cpp-samples.md)   
- [SimpleImage Sample](../../top/visual-cpp-samples.md)   
+ [MMXSwarm Sample](../../visual-cpp-samples.md)   
+ [SimpleImage Sample](../../visual-cpp-samples.md)   
  [Device-Independent Bitmaps](http://msdn.microsoft.com/library/windows/desktop/dd183562)   
  [CreateDIBSection](http://msdn.microsoft.com/library/windows/desktop/dd183494)   
  [ATL COM Desktop Components](../../atl/atl-com-desktop-components.md)

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

@@ -366,7 +366,7 @@ CSize operator-(POINT point) const throw();
  [!code-cpp[NVC_ATLMFC_Utilities#34](../../atl-mfc-shared/codesnippet/cpp/cpoint-class_7.cpp)]  
 
 ## See Also  
- [MFC Sample MDI](../../top/visual-cpp-samples.md)   
+ [MFC Sample MDI](../../visual-cpp-samples.md)   
  [Hierarchy Chart](../../mfc/hierarchy-chart.md)   
  [POINT Structure](../../mfc/reference/point-structure1.md)   
  [CRect Class](../../atl-mfc-shared/reference/crect-class.md)   

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

@@ -262,7 +262,7 @@ CSize operator-() const throw();
  [!code-cpp[NVC_ATLMFC_Utilities#103](../../atl-mfc-shared/codesnippet/cpp/csize-class_7.cpp)]  
 
 ## See Also  
- [MFC Sample MDI](../../top/visual-cpp-samples.md)   
+ [MFC Sample MDI](../../visual-cpp-samples.md)   
  [Hierarchy Chart](../../mfc/hierarchy-chart.md)   
  [CRect Class](../../atl-mfc-shared/reference/crect-class.md)   
  [CPoint Class](../../atl-mfc-shared/reference/cpoint-class.md)

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

@@ -213,7 +213,7 @@ CTime() throw();
  A [FILETIME](https://www.microsoftonedoc.com/#/organizations/e6f6a65cf14f462597b64ac058dbe1d0/projects/3fedad16-eaf1-41a6-8f96-0c1949c68f32/containers/a3daf831-1c5f-4bbe-964d-503870caf874/tocpaths/979ce746-dc17-4147-89f8-41d05c5fcc5f/locales/en-us) structure to be converted to a date/time value and copied into the new `CTime` object.  
 
  dbts  
- A reference to a <xref:System.Data.OleDb.OleDbTypequalifyHint%3DFalse%26autoUpgrade%3DTrue> structure containing the current local time.  
+ A reference to a DBTIMESTAMP structure containing the current local time.  
 
 ### Remarks  
  Each constructor is described below:  
@@ -312,15 +312,15 @@ CString FormatGmt(UINT nFormatID) const;
  See the example for [CTime::Format](#ctime__format).  
 
 ##  <a name="ctime__getasdbtimestamp"></a>  CTime::GetAsDBTIMESTAMP  
- Call this member function to convert the time information stored in the `CTime` object to a Win32–compatible <xref:System.Data.OleDb.OleDbTypequalifyHint%3DFalse%26autoUpgrade%3DTrue> structure.  
+ Call this member function to convert the time information stored in the `CTime` object to a Win32–compatible DBTIMESTAMP structure.  
 
 ```  
 bool GetAsDBTIMESTAMP(DBTIMESTAMP& dbts) const throw();
 ```  
 
 ### Parameters  
  `dbts`  
- A reference to a <xref:System.Data.OleDb.OleDbTypequalifyHint%3DFalse%26autoUpgrade%3DTrue> structure containing the current local time.  
+ A reference to a DBTIMESTAMP structure containing the current local time.  
 
 ### Return Value  
  Nonzero if successful; otherwise 0.  

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

@@ -105,7 +105,7 @@ The Active Template Library (ATL) is a set of template-based C++ classes that le
  Provides code for manipulating paths and URLs in the form of [CPathT](../atl/reference/cpatht-class.md) and [CUrl](../atl/reference/curl-class.md). A thread pool, [CThreadPool](../atl/reference/cthreadpool-class.md), can be used in your own applications. This code can be found in atlpath.h and atlutil.h.  
 
 ## Related Sections  
- [ATL Samples](../top/visual-cpp-samples.md)  
+ [ATL Samples](../visual-cpp-samples.md)  
  Provides descriptions of and links to the ATL sample programs.  
 
  [Creating an ATL Project](../atl/reference/creating-an-atl-project.md)  

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

@@ -56,7 +56,7 @@ The [ATL Tutorial](../atl/active-template-library-atl-tutorial.md) demonstrates
 
      [!code-cpp[NVC_ATL_Windowing#82](../atl/codesnippet/cpp/adding-connection-points-to-an-object_2.idl)]  
 
-     See the .idl file in the [Circ](../top/visual-cpp-samples.md) ATL sample for an example.  
+     See the .idl file in the [Circ](../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/atl-collection-classes.md

@@ -128,13 +128,13 @@ ATL provides many classes for storing and accessing data. Which class you decide
 ## Collection Classes Samples  
  The following samples demonstrate the collection classes:  
 
--   [MMXSwarm Sample](../top/visual-cpp-samples.md)  
+-   [MMXSwarm Sample](../visual-cpp-samples.md)  
 
--   [DynamicConsumer Sample](../top/visual-cpp-samples.md)  
+-   [DynamicConsumer Sample](../visual-cpp-samples.md)  
 
--   [UpdatePV Sample](../top/visual-cpp-samples.md)  
+-   [UpdatePV Sample](../visual-cpp-samples.md)  
 
--   [Marquee Sample](../top/visual-cpp-samples.md)  
+-   [Marquee Sample](../visual-cpp-samples.md)  
 
 ## See Also  
  [Concepts](../atl/active-template-library-atl-concepts.md)   

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

@@ -58,7 +58,7 @@ A `collection` is a COM object that provides an interface that allows access to
  [ATL](../atl/active-template-library-atl-concepts.md)  
  Provides links to conceptual topics on how to program using the Active Template Library.  
 
- [ATLCollections Sample](../top/visual-cpp-samples.md)  
+ [ATLCollections Sample](../visual-cpp-samples.md)  
  A sample that demonstrates the use of `ICollectionOnSTLImpl` and `CComEnumOnSTL`, and the implementation of custom copy policy classes.  
 
 ## See Also  

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

@@ -71,7 +71,7 @@ The ATL Reference documents the Active Template Library (ATL), a set of template
  [ATL Tutorial](../atl/active-template-library-atl-tutorial.md)  
  Leads you through the creation of a control and demonstrates some ATL fundamentals in the process.  
 
- [ATL Samples](../top/visual-cpp-samples.md)  
+ [ATL Samples](../visual-cpp-samples.md)  
  Sample code that shows how to use ATL to write COM objects.  
 
  [OLE DB Templates](../data/oledb/ole-db-templates.md)  

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

@@ -54,7 +54,7 @@ COM property pages provide a user interface for setting the properties (or calli
  Lists the steps for implementing property pages, including methods to override. Walks you through a complete example based on the ATLPages sample program.  
 
 ## Related Sections  
- [ATLPages Sample](../top/visual-cpp-samples.md)  
+ [ATLPages Sample](../visual-cpp-samples.md)  
  The sample abstract for the ATLPages sample, which implements a property page using `IPropertyPageImpl`.  
 
  [ATL](../atl/active-template-library-atl-concepts.md)  

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

@@ -80,7 +80,7 @@ Copy policy classes are [utility classes](../atl/utility-classes.md) used to ini
 -   The **_CopyInterface** class provides an implementation for copying interface pointers following standard COM rules. Once again this class allows only homogeneous copying, so it uses simple assignment and a call to `AddRef` to perform the copy.  
 
 ## 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](../top/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](../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  
  `GenericCopy` allows you to specify the *SourceType* and `DestinationType` as template arguments. Here's the most general form of the `GenericCopy` class from VCUE_Copy.h:  
@@ -96,5 +96,5 @@ Copy policy classes are [utility classes](../atl/utility-classes.md) used to ini
 
 ## See Also  
  [Implementing an STL-Based Collection](../atl/implementing-an-stl-based-collection.md)   
- [ATLCollections Sample](../top/visual-cpp-samples.md)
+ [ATLCollections Sample](../visual-cpp-samples.md)
 

docs/atl/changing-the-drawing-code-atl-tutorial-part-4.md

@@ -100,7 +100,7 @@ By default, the control's drawing code displays a square and the text **PolyCtl*
 
 #### To use the ActiveX Control Test Container  
 
-1.  Build and start the ActiveX Control Test Container. For more information, see [TSTCON Sample: ActiveX Control Test Container](../top/visual-cpp-samples.md).  
+1.  Build and start the ActiveX Control Test Container. For more information, see [TSTCON Sample: ActiveX Control Test Container](../visual-cpp-samples.md).  
 
 2.  In Test Container, on the **Edit** menu, click **Insert New Control**.  
 

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

@@ -49,7 +49,7 @@ The following classes provide general support for ATL controls:
 -   [IPointerInactiveImpl](../atl/reference/ipointerinactiveimpl-class.md) Provides minimal mouse interaction for an otherwise inactive control.  
 
 ## Sample Program  
- [ATLFire](../top/visual-cpp-samples.md)  
+ [ATLFire](../visual-cpp-samples.md)  
 
 ## Related Articles  
  [ATL Tutorial](../atl/active-template-library-atl-tutorial.md)  

docs/atl/creating-the-project-atl-tutorial-part-1.md

@@ -37,7 +37,7 @@ This tutorial walks you step-by-step through a nonattributed ATL project that cr
 >  ATL and MFC are not generally supported in the Express editions of Visual Studio.  
   
 > [!NOTE]
->  This tutorial creates the same source code as the Polygon sample. If you want to avoid entering the source code manually, you can download it from the [Polygon sample abstract](../top/visual-cpp-samples.md). You can then refer to the Polygon source code as you work through the tutorial, or use it to check for errors in your own project.  
+>  This tutorial creates the same source code as the Polygon sample. If you want to avoid entering the source code manually, you can download it from the [Polygon sample abstract](../visual-cpp-samples.md). You can then refer to the Polygon source code as you work through the tutorial, or use it to check for errors in your own project.  
   
 ### To create the initial ATL project using the ATL Project Wizard  
 

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

@@ -35,7 +35,7 @@ translation.priority.ht:
 # Example: Implementing a Property Page
 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. This interface is exposed by documents in Visual Studio's [Common Environment Object Model Examples](http://msdn.microsoft.com/library/919cdb58-9f6d-45e6-a0f1-9ca8f6e7051f) (although the property page that you'll create won't care where the objects it manipulates come from as long as they support the correct interface).  
 
- The example is based on the [ATLPages sample](../top/visual-cpp-samples.md).  
+ The example is based on the [ATLPages sample](../visual-cpp-samples.md).  
 
  To complete this example, you will:  
 
@@ -179,5 +179,5 @@ End Module
 
 ## See Also  
  [Property Pages](../atl/atl-com-property-pages.md)   
- [ATLPages Sample](../top/visual-cpp-samples.md)
+ [ATLPages Sample](../visual-cpp-samples.md)
 

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

@@ -35,7 +35,7 @@ translation.priority.ht:
 # Implementing an STL-Based Collection
 ATL provides the `ICollectionOnSTLImpl` interface to enable you to quickly implement Standard Template Library (STL)-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](../top/visual-cpp-samples.md).  
+ The sample code is from the [ATLCollections sample](../visual-cpp-samples.md).  
 
  To complete this procedure, you will:  
 
@@ -91,7 +91,7 @@ ATL provides the `ICollectionOnSTLImpl` interface to enable you to quickly imple
 
  [!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](../top/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](../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  
  Now all the template parameters necessary to specialize the `CComEnumOnSTL` and `ICollectionOnSTLImpl` classes for this situation have been provided in the form of typedefs. To simplify the use of the specializations, create two more typedefs as shown below:  
@@ -114,6 +114,6 @@ ATL provides the `ICollectionOnSTLImpl` interface to enable you to quickly imple
 
 ## See Also  
  [Collections and Enumerators](../atl/atl-collections-and-enumerators.md)   
- [ATLCollections Sample](../top/visual-cpp-samples.md)   
+ [ATLCollections Sample](../visual-cpp-samples.md)   
  [ATL Copy Policy Classes](../atl/atl-copy-policy-classes.md)
 

docs/atl/implementing-property-pages.md

@@ -67,5 +67,5 @@ Property pages are COM objects that implement the `IPropertyPage` or **IProperty
   
 ## See Also  
  [Property Pages](../atl/atl-com-property-pages.md)   
- [ATLPages Sample](../top/visual-cpp-samples.md)
+ [ATLPages Sample](../visual-cpp-samples.md)
 

docs/atl/reference/atl-path-functions.md

@@ -53,7 +53,7 @@ ATL provides the ATLPath class for manipulating paths in the form of [CPathT](cp
 |[ATLPath::IsPrefix](#atlpath__isprefix)|This function is an overloaded wrapper for [PathIsPrefix](http://msdn.microsoft.com/library/windows/desktop/bb773650).|  
 |[ATLPath::IsRelative](#atlpath__isrelative)|This function is an overloaded wrapper for [PathIsRelative](http://msdn.microsoft.com/library/windows/desktop/bb773660).|  
 |[ATLPath::IsRoot](#atlpath__isroot)|This function is an overloaded wrapper for [PathIsRoot](http://msdn.microsoft.com/library/windows/desktop/bb773674).|  
-|[ATLPath::IsSameRoot](#atlpath__issameRoot)|This function is an overloaded wrapper for [PathIsSameRoot](http://msdn.microsoft.com/library/windows/desktop/bb773687).|  
+|[ATLPath::IsSameRoot](#atlpath__issameroot)|This function is an overloaded wrapper for [PathIsSameRoot](http://msdn.microsoft.com/library/windows/desktop/bb773687).|  
 |[ATLPath::IsUNC](#atlpath__isunc)|This function is an overloaded wrapper for [PathIsUNC](http://msdn.microsoft.com/library/windows/desktop/bb773712).|  
 |[ATLPath::IsUNCServer](#atlpath__isuncserver)|This function is an overloaded wrapper for [PathIsUNCServer](http://msdn.microsoft.com/library/windows/desktop/bb773722).|  
 |[ATLPath::IsUNCServerShare](#atlpath__isuncservershare)|This function is an overloaded wrapper for [PathIsUNCServerShare](http://msdn.microsoft.com/library/windows/desktop/bb773723).|  

docs/atl/reference/caccesstoken-class.md

@@ -1005,6 +1005,6 @@ bool SetPrimaryGroup(const CSid& rSid) throw(...);
  The primary group is the default group for new objects created while this access token is in effect.  
 
 ## See Also  
- [ATLSecurity Sample](../../top/visual-cpp-samples.md)   
+ [ATLSecurity Sample](../../visual-cpp-samples.md)   
  [Access Tokens](http://msdn.microsoft.com/library/windows/desktop/aa374909)   
  [Class Overview](../../atl/atl-class-overview.md)