Merge pull request #896 from MicrosoftDocs/master

Taojunshen · web-flow · commit a69fa38b50b3 · 2018-06-13T10:38:25.000-07:00
6/13 AM Publish
diff --git a/docs/build/media/desktop-app-project-run-157.PNG b/docs/build/media/desktop-app-project-run-157.PNG
diff --git a/docs/build/reference/dynamicbase-use-address-space-layout-randomization.md b/docs/build/reference/dynamicbase-use-address-space-layout-randomization.md
@@ -1,7 +1,7 @@
 ---
 title: "-DYNAMICBASE (Use address space layout randomization) | Microsoft Docs"
 ms.custom: ""
-ms.date: "11/04/2016"
+ms.date: "06/12/2018"
 ms.technology: ["cpp-tools"]
 ms.topic: "reference"
 f1_keywords: ["VC.Project.VCLinkerTool.RandomizedBaseAddress"]
@@ -13,37 +13,34 @@ ms.author: "corob"
 ms.workload: ["cplusplus"]
 ---
 # /DYNAMICBASE (Use address space layout randomization)
-Specifies whether to generate an executable image that can be randomly rebased at load time by using the address space layout randomization (ASLR) feature of [!INCLUDE[windowsver](../../build/reference/includes/windowsver_md.md)].  
-  
-## Syntax  
-  
-```  
-/DYNAMICBASE[:NO]  
-```  
-  
-## Remarks  
- By default, /DYNAMICBASE is on.  
-  
- This option modifies the header of an executable to indicate whether the application should be randomly rebased at load time.  
-  
- Address space layout randomization is supported on [!INCLUDE[windowsver](../../build/reference/includes/windowsver_md.md)].  
-  
-### To set this linker option in Visual Studio  
-  
-1.  Open the project **Property Pages** dialog box. For more information, see [Working with Project Properties](../../ide/working-with-project-properties.md).  
-  
-2.  Expand the **Configuration Properties** node.  
-  
-3.  Expand the **Linker** node.  
-  
-4.  Select the **Advanced** property page.  
-  
-5.  Modify the **Randomized Base Address** property.  
-  
-### To set this linker option programmatically  
-  
-1.  See <xref:Microsoft.VisualStudio.VCProjectEngine.VCLinkerTool.RandomizedBaseAddress%2A>.  
-  
-## See Also  
- [Setting Linker Options](../../build/reference/setting-linker-options.md)   
- [Linker Options](../../build/reference/linker-options.md)
+
+Specifies whether to generate an executable image that can be randomly rebased at load time by using the address space layout randomization (ASLR) feature of Windows that was first available in Windows Vista.
+
+## Syntax
+
+> **/DYNAMICBASE**[**:NO**]
+
+## Remarks
+
+The **/DYNAMICBASE** option modifies the header of an *executable image*, a .dll or .exe file, to indicate whether the application should be randomly rebased at load time, and enables virtual address allocation randomization, which affects the virtual memory location of heaps, stacks, and other operating system allocations. The **/DYNAMICBASE** option applies to both 32-bit and 64-bit images. ASLR is supported on Windows Vista and later operating systems. The option is ignored by earlier operating systems.
+
+By default, **/DYNAMICBASE** is enabled. To disable this option, use **/DYNAMICBASE:NO**. The **/DYNAMICBASE** option is required for the [/HIGHENTROPYVA](highentropyva-support-64-bit-aslr.md) option to have an effect.
+
+### To set this linker option in Visual Studio
+
+1. Open the project **Property Pages** dialog box. For more information, see [Working with Project Properties](../../ide/working-with-project-properties.md).
+
+1. Select the **Configuration Properties** > **Linker** > **Advanced** property page.
+
+1. Modify the **Randomized Base Address** property.
+
+### To set this linker option programmatically
+
+- See <xref:Microsoft.VisualStudio.VCProjectEngine.VCLinkerTool.RandomizedBaseAddress%2A>.
+
+## See also
+
+- [Setting Linker Options](../../build/reference/setting-linker-options.md)
+- [Linker Options](../../build/reference/linker-options.md)
+- [/HIGHENTROPYVA](highentropyva-support-64-bit-aslr.md)
+- [Windows ISV Software Security Defenses](http://msdn.microsoft.com/library/bb430720.aspx)
diff --git a/docs/build/reference/dynamicbase.md b/docs/build/reference/dynamicbase.md
@@ -1,7 +1,7 @@
 ---
 title: "-DYNAMICBASE | Microsoft Docs"
 ms.custom: ""
-ms.date: "11/04/2016"
+ms.date: "06/12/2018"
 ms.technology: ["cpp-tools"]
 ms.topic: "reference"
 f1_keywords: ["/dynamicbase"]
@@ -13,22 +13,20 @@ ms.author: "corob"
 ms.workload: ["cplusplus"]
 ---
 # /DYNAMICBASE
-Specifies whether an executable image can be randomly rebased at load time by using address space layout randomization (ASLR).  
-  
-## Syntax  
-  
-```  
-  
-/DYNAMICBASE[:NO]  
-```  
-  
-## Remarks  
- By default, the linker sets the **/DYNAMICBASE** option.  
-  
- This option modifies the header of an executable image to indicate whether the loader can randomly rebase the image at load time.  
-  
- ASLR is supported on Windows Vista, Windows Server 2008, Windows 7, Windows 8, and Windows Server 2012.  
-  
-## See Also  
- [EDITBIN Options](../../build/reference/editbin-options.md)   
- [Windows ISV Software Security Defenses](http://msdn.microsoft.com/library/bb430720.aspx)
+
+Specifies whether to generate an executable image that can be randomly rebased at load time by using the address space layout randomization (ASLR) feature of Windows that was first available in Windows Vista.
+
+## Syntax
+
+> **/DYNAMICBASE**[**:NO**]
+
+## Remarks
+
+The **/DYNAMICBASE** option modifies the header of an *executable image*, a .dll or .exe file, to indicate whether the application should be randomly rebased at load time, and enables virtual address allocation randomization, which affects the virtual memory location of heaps, stacks, and other operating system allocations. The **/DYNAMICBASE** option applies to both 32-bit and 64-bit images. ASLR is supported on Windows Vista and later operating systems. The option is ignored by earlier operating systems.
+
+By default, **/DYNAMICBASE** is enabled. To disable this option, use **/DYNAMICBASE:NO**. The **/DYNAMICBASE** option is required for the [/HIGHENTROPYVA](highentropyva-support-64-bit-aslr.md) option to have an effect.
+
+## See also
+
+- [EDITBIN Options](../../build/reference/editbin-options.md)
+- [Windows ISV Software Security Defenses](http://msdn.microsoft.com/library/bb430720.aspx)
diff --git a/docs/build/reference/highentropyva-support-64-bit-aslr.md b/docs/build/reference/highentropyva-support-64-bit-aslr.md
@@ -1,7 +1,7 @@
 ---
-title: "-HIGHENTROPYVA (Support 64-Bit ASLR) | Microsoft Docs"
+title: "/HIGHENTROPYVA (Support 64-Bit ASLR) | Microsoft Docs"
 ms.custom: ""
-ms.date: "11/04/2016"
+ms.date: "06/12/2018"
 ms.technology: ["cpp-tools"]
 ms.topic: "reference"
 dev_langs: ["C++"]
@@ -11,31 +11,33 @@ ms.author: "corob"
 ms.workload: ["cplusplus"]
 ---
 # /HIGHENTROPYVA (Support 64-Bit ASLR)
-Specifies that the executable image supports high-entropy 64-bit address space layout randomization (ASLR).  
-  
-## Syntax  
-  
-```  
-/HIGHENTROPYVA[:NO]  
-```  
-  
-## Remarks  
- By default, /HIGHENTROPYVA is on for 64-bit executable images. It is not applicable to 32-bit executable images. To enable this option, /DYNAMICBASE must also be on.  
-  
- /HIGHENTROPYVA modifies the header of a .dll file or .exe file to indicate whether ASLR with 64-bit addresses is supported. When this option is set on an executable and all of the modules that it depends on, an operating system that supports 64-bit ASLR can rebase the segments of the executable image at load time by using randomized addresses in a 64-bit virtual address space. This large address space makes it more difficult for an attacker to guess the location of a particular memory region.  
-  
-### To set this linker option in Visual Studio  
-  
-1.  Open the project **Property Pages** dialog box. For more information, see [Working with Project Properties](../../ide/working-with-project-properties.md).  
-  
-2.  Expand the **Configuration Properties** node.  
-  
-3.  Expand the **Linker** node.  
-  
-4.  Select the **Command Line** property page.  
-  
-5.  In **Additional Options**, enter `/HIGHENTROPYVA` or `/HIGHENTROPYVA:NO`.  
-  
-## See Also  
- [Setting Linker Options](../../build/reference/setting-linker-options.md)   
- [Linker Options](../../build/reference/linker-options.md)
+
+Specifies whether the executable image supports high-entropy 64-bit address space layout randomization (ASLR).
+
+## Syntax
+
+> **/HIGHENTROPYVA**[**:NO**]
+
+## Remarks
+
+**/HIGHENTROPYVA** modifies the header of an *executable image*, a .dll file or .exe file, to indicate whether ASLR can use the entire 64-bit address space. When this option is set on an executable and all of the modules that it depends on, an operating system that supports 64-bit ASLR can rebase the segments of the executable image at load time by using randomized addresses in a 64-bit virtual address space. This large address space makes it more difficult for an attacker to guess the location of a particular memory region.
+
+By default, **/HIGHENTROPYVA** is enabled for 64-bit executable images. This option requires [/LARGEADDRESSAWARE](largeaddressaware-handle-large-addresses.md), which is also enabled by default for 64-bit images. **/HIGHENTROPYVA** is not applicable to 32-bit executable images, where the linker ignores the option. To explicitly disable this option, use **/HIGHENTROPYVA:NO**.
+
+For **/HIGHENTROPYVA** to have an effect at load time, [/DYNAMICBASE](dynamicbase-use-address-space-layout-randomization.md) must also be enabled. **/DYNAMICBASE** is enabled by default, and is required to enable ASLR in Windows Vista and later operating systems. Earlier versions of Windows ignore this flag.
+
+### To set this linker option in Visual Studio
+
+1. Open the project **Property Pages** dialog box. For more information, see [Working with Project Properties](../../ide/working-with-project-properties.md).
+
+1. Select the **Configuration Properties** > **Linker** > **Command Line** property page.
+
+1. In **Additional Options**, enter `/HIGHENTROPYVA` or `/HIGHENTROPYVA:NO`.
+
+## See also
+
+- [Setting Linker Options](../../build/reference/setting-linker-options.md)
+- [Linker Options](../../build/reference/linker-options.md)
+- [/DYNAMICBASE](dynamicbase-use-address-space-layout-randomization.md)
+- [/LARGEADDRESSAWARE](largeaddressaware-handle-large-addresses.md)
+- [Windows ISV Software Security Defenses](http://msdn.microsoft.com/library/bb430720.aspx)
diff --git a/docs/build/reference/highentropyva.md b/docs/build/reference/highentropyva.md
@@ -1,7 +1,7 @@
 ---
 title: "-HIGHENTROPYVA | Microsoft Docs"
 ms.custom: ""
-ms.date: "11/04/2016"
+ms.date: "06/12/2018"
 ms.technology: ["cpp-tools"]
 ms.topic: "reference"
 f1_keywords: ["/HIGHENTROPYVA"]
@@ -13,19 +13,21 @@ ms.author: "corob"
 ms.workload: ["cplusplus"]
 ---
 # /HIGHENTROPYVA
-Specifies whether the executable image supports high-entropy 64-bit address space layout randomization (ASLR).  
-  
-```  
-  
-/HIGHENTROPYVA[:NO]  
-```  
-  
-## Remarks  
- This option modifies the header of a .dll file or .exe file to indicate whether ASLR with 64-bit addresses is supported. When this option is set on an executable and all of the modules that it depends on, an operating system that supports 64-bit ASLR can rebase the segments of the executable image at load time by using randomized addresses in a 64-bit virtual address space. This large address space makes it more difficult for an attacker to guess the location of a particular memory region.  
-  
- By default, the linker sets this option for 64-bit executable images. To set this option, the [/DYNAMICBASE](../../build/reference/dynamicbase.md) option must also be set.  
-  
-## See Also  
- [EDITBIN Options](../../build/reference/editbin-options.md)   
- [/DYNAMICBASE](../../build/reference/dynamicbase.md)   
- [Windows ISV Software Security Defenses](http://msdn.microsoft.com/library/bb430720.aspx)
+
+Specifies whether the executable image supports high-entropy 64-bit address space layout randomization (ASLR).
+
+## Syntax
+
+> **/HIGHENTROPYVA**[**:NO**]
+
+## Remarks
+
+This option modifies the header of an *executable image*, a .dll file or .exe file, to indicate whether ASLR with 64-bit addresses is supported. When this option is set on an executable and all of the modules that it depends on, an operating system that supports 64-bit ASLR can rebase the segments of the executable image at load time by using randomized addresses in a 64-bit virtual address space. This large address space makes it more difficult for an attacker to guess the location of a particular memory region.
+
+By default, the linker enables **/HIGHENTROPYVA** for 64-bit executable images. This option requires [/LARGEADDRESSAWARE](largeaddressaware.md), which is also enabled by default for 64-bit images. **/HIGHENTROPYVA** is not applicable to 32-bit executable images, where the option is ignored. To explicitly disable this option, use **/HIGHENTROPYVA:NO**. For this option to have an effect, the [/DYNAMICBASE](dynamicbase.md) option must also be set.
+
+## See also
+
+- [EDITBIN Options](editbin-options.md)
+- [/DYNAMICBASE](dynamicbase.md)
+- [Windows ISV Software Security Defenses](http://msdn.microsoft.com/library/bb430720.aspx)
diff --git a/docs/ide/resource-files-cpp.md b/docs/ide/resource-files-cpp.md
@@ -20,12 +20,12 @@ Resources are interface elements that provide information to the user. Bitmaps,
 |---------------|------------------------|--------------------------------|-----------------|  
 |*Projname*.rc|*Projname*|Source Files|The resource script file for the project. The resource script file contains the following, depending on the type of project, and the support selected for the project (for example, toolbars, dialog boxes, or HTML):<br /><br /> -   Default menu definition.<br />-   Accelerator and string tables.<br />-   Default **About** dialog box.<br />-   Other dialog boxes.<br />-   Icon file (res\\*Projname*.ico).<br />-   Version information.<br />-   Bitmaps.<br />-   Toolbar.<br />-   HTML files.<br /><br /> The resource file includes the file Afxres.rc for standard Microsoft Foundation Class resources.|  
 |Resource.h|*Projname*|Header Files|The resource header file that includes definitions for the resources used by the project.|  
-|*Projname*.rc2|*Projname*\res|Source Files|The script file containing additional resources used by the project. You can include the .rc2 file at the top of the project's .rc file.<br /><br /> An .rc2 file is useful for including resources used by several different projects. Instead of having to create the same resources several times for different projects, you can put them in an .rc2 file and include the .rc2 file into the main .rc file.|  
+|*Projname*.rc2|*Projname*\res|Source Files|The script file containing additional resources used by the project. You can include the .rc2 file under the project's .rc file.<br /><br /> An .rc2 file is useful for including resources used by several different projects. Instead of having to create the same resources several times for different projects, you can put them in an .rc2 file and include the .rc2 file into the main .rc file.|  
 |*Projname*.def|*Projname*|Source Files|The module definition file for a DLL project. For a control, it provides the name and description of the control, as well as the size of the run-time heap.|  
 |*Projname*.ico|*Projname*\res|Resource Files|The icon file for the project or control. This icon appears when the application is minimized. It is also used in the application's **About** box. By default, MFC provides the MFC icon, and ATL provides the ATL icon.|  
 |*Projname*Doc.ico|*Projname*\res|Resource Files|The icon file for an MFC project that includes support for the document/view architecture.|  
 |Toolbar.bmp|*Projname*\res|Resource Files|The bitmap file representing the application or control in a toolbar or palette. This bitmap is included in the project's resource file. The initial toolbar and status bar are constructed in the **CMainFrame** class.|  
 |ribbon.mfcribbon-ms|*Projname*\res|Resource Files|The resource file that contains the XML code that defines the buttons, controls, and attributes in the ribbon. For more information, see [Ribbon Designer (MFC)](../mfc/ribbon-designer-mfc.md).|  
   
 ## See Also  
- [File Types Created for Visual C++ Projects](../ide/file-types-created-for-visual-cpp-projects.md)
+ [File Types Created for Visual C++ Projects](../ide/file-types-created-for-visual-cpp-projects.md)
diff --git a/docs/mfc/reference/cfile-class.md b/docs/mfc/reference/cfile-class.md
@@ -1,7 +1,7 @@
 ---
 title: "CFile Class | Microsoft Docs"
 ms.custom: ""
-ms.date: "11/04/2016"
+ms.date: "06/12/2018"
 ms.technology: ["cpp-mfc"]
 ms.topic: "reference"
 f1_keywords: ["CFile", "AFX/CFile", "AFX/CFile::CFile", "AFX/CFile::Abort", "AFX/CFile::Close", "AFX/CFile::Duplicate", "AFX/CFile::Flush", "AFX/CFile::GetFileName", "AFX/CFile::GetFilePath", "AFX/CFile::GetFileTitle", "AFX/CFile::GetLength", "AFX/CFile::GetPosition", "AFX/CFile::GetStatus", "AFX/CFile::LockRange", "AFX/CFile::Open", "AFX/CFile::Read", "AFX/CFile::Remove", "AFX/CFile::Rename", "AFX/CFile::Seek", "AFX/CFile::SeekToBegin", "AFX/CFile::SeekToEnd", "AFX/CFile::SetFilePath", "AFX/CFile::SetLength", "AFX/CFile::SetStatus", "AFX/CFile::UnlockRange", "AFX/CFile::Write", "AFX/CFile::hFileNull", "AFX/CFile::m_hFile", "AFX/CFile::m_pTM"]
@@ -177,7 +177,7 @@ CAtlTransactionManager* pTM);
   
 |Value|Description|  
 |-----------|-----------------|  
-|`CFile::modeCreate`|Creates a new file if no file exists.; If the file already exists, [CFileException](../../mfc/reference/cfileexception-class.md) is raised.|  
+|`CFile::modeCreate`|Creates a new file if no file exists. If the file already exists, it is overwritten and initially set to zero length.|  
 |`CFile::modeNoTruncate`|Creates a new file if no file exists; otherwise, if the file already exists, it is attached to the `CFile` object.|  
   
  Choose the following file caching options as described. By default, the system uses a general purpose caching scheme that is not available as an option.  
diff --git a/docs/windows/walkthrough-creating-windows-desktop-applications-cpp.md b/docs/windows/walkthrough-creating-windows-desktop-applications-cpp.md
@@ -1,7 +1,7 @@
 ---
 title: "Walkthrough: Create a traditional Windows Desktop application (C++) | Microsoft Docs"
 ms.custom: "get-started-article"
-ms.date: "1/11/2018"
+ms.date: "06/12/2018"
 ms.technology: ["cpp-windows"]
 ms.topic: "conceptual"
 dev_langs: ["C++"]
@@ -552,7 +552,7 @@ As promised, here's the complete code for the working application.
 
 1. To run the application, press **F5**. A window that contains the text "Hello, Windows desktop!" should appear in the upper-left corner of the display.
 
-   ![Run the DesktopApp Project](../build/media/desktop-app-project-run-150.gif "Run the DesktopApp Project")
+   ![Run the DesktopApp Project](../build/media/desktop-app-project-run-157.png "Run the DesktopApp Project")
 
 Congratulations! You've completed this walkthrough and built a traditional Windows desktop application.
 
