Merge pull request #1461 from msebolt/oledb-procedural-pr1

oledb procedural pr1

Author: Colin Robertson

docs/data/oledb/creating-a-simple-consumer.md

@@ -1,7 +1,7 @@
 ---
 title: "Creating a Simple Consumer | Microsoft Docs"
 ms.custom: ""
-ms.date: "11/04/2016"
+ms.date: "10/09/2018"
 ms.technology: ["cpp-data"]
 ms.topic: "reference"
 dev_langs: ["C++"]
@@ -15,35 +15,35 @@ ms.workload: ["cplusplus", "data-storage"]
 
 Use the ATL Project Wizard and ATL OLE DB Consumer Wizard to generate an OLE DB Templates consumer.
 
-### To create a console application for an OLE DB consumer
+## To create a console application for an OLE DB consumer
 
 1. On the **File** menu, click **New**, and then click **Project**.
 
    The **New Project** dialog box appears.
 
-1. In the Project Types pane, click the **Visual C++ Projects** folder, and then click the **Win32 Project** icon in the Templates pane. In the **Name** box, enter the name of your project, for example, **MyCons**.
+1. In the **Project Types** pane, click the **Installed** > **Templates** > **Visual C++** folder, and then click the **Win32 Console Application** icon in the **Templates** pane. In the **Name** box, enter the name of your project, for example, *MyCons*.
 
 1. Click **OK**.
 
-   The Win32 Project Wizard appears.
+   The Win32 Application Wizard appears.
 
-1. On the **Application Settings** page, select **Console application**, and then select **Add support for ATL**.
+1. On the **Application Settings** page, select **Console application**, and then select **Add common header files for ATL**.
 
 1. Click **Finish** to close the wizard and generate the project.
 
 Next, use the ATL OLE DB Consumer Wizard to add an OLE DB consumer object.
 
-#### To create a consumer with the ATL OLE DB Consumer Wizard
+## To create a consumer with the ATL OLE DB Consumer Wizard
 
-1. In Class View, right-click the `MyCons` project.
+1. In **Solution Explorer**, right-click the `MyCons` project.
 
-1. On the shortcut menu, click **Add**, and then click **Add Class**.
+1. On the shortcut menu, click **Add**, and then click **Class**.
 
    The **Add Class** dialog box appears.
 
-1. In the Categories pane, click **Visual C++**, click the **ATL OLE DB Consumer** icon in the Templates pane, and then click **Open**.
+1. In the **Categories** pane, click **Installed** > **Visual C++** > **ATL**, click the **ATL OLEDB Consumer** icon in the **Templates** pane, and then click **Add**.
 
-   The ATL OLE DB Consumer Wizard appears.
+   The ATL OLEDB Consumer Wizard appears.
 
 1. Click the **Data Source** button.
 
@@ -53,10 +53,10 @@ Next, use the ATL OLE DB Consumer Wizard to add an OLE DB consumer object.
 
    - On the **Provider** tab, specify an OLE DB provider.
 
-   - On the **Connection** tab, specify the server name, logon ID, and password for your data source and database on the server.
+   - On the **Connection** tab, specify the required information, such as server name, logon ID, and password for your data source and database on the server.
 
    > [!NOTE]
-   > There is a security issue with the **Allow saving of password** feature of the **Data Link Properties** dialog box. In **Enter information to log on to the server**, there are two radio buttons: **Use Windows NT integrated security** and **Use a specific user name and password**.
+   > There is a security issue with the **Allow saving password** feature of the **Data Link Properties** dialog box. In **Enter information to log on to the server**, there are two radio buttons: **Use Windows NT integrated security** and **Use a specific user name and password**.
 
    > [!NOTE]
    > If you select **Use a specific user name and password**, you have the option of saving the password (using the **Allow saving password** check box); however, this option is not secure. It is recommended that you select **Use Windows NT integrated security**; this option uses Windows NT to verify your identity.
@@ -68,7 +68,7 @@ Next, use the ATL OLE DB Consumer Wizard to add an OLE DB consumer object.
 
    The **Select Database Object** dialog box appears.
 
-1. Use the tree control to select a table, view, or stored procedure. For the purpose of this procedure, select the Products table from the Northwind database.
+1. Use the tree control to select a table, view, or stored procedure. For the purpose of this procedure, select the `Products` table from the `Northwind` database.
 
 1. Click **OK**. This returns you to the ATL OLE DB Consumer Wizard.
 

docs/data/oledb/implementing-a-simple-consumer.md

@@ -22,17 +22,17 @@ The following topics show how to edit the files created by the MFC Application W
 - "Adding XML Support to the Consumer" shows how to modify the consumer code to output the retrieved rowset data as XML data.  
 
 > [!NOTE]
->  You can use the consumer application described in this section to test the MyProv and Provider sample providers.  
+> You can use the consumer application described in this section to test the MyProv and Provider sample providers.  
   
 > [!NOTE]
->  To build a consumer application to test MyProv (the same provider described in [Enhancing the Simple Read-Only Provider](../../data/oledb/enhancing-the-simple-read-only-provider.md)), you must include bookmark support as described in "Adding Bookmark Support to the Consumer."  
+> To build a consumer application to test MyProv (the same provider described in [Enhancing the Simple Read-Only Provider](../../data/oledb/enhancing-the-simple-read-only-provider.md)), you must include bookmark support as described in "Adding Bookmark Support to the Consumer."  
   
 > [!NOTE]
->  To build a consumer application to test Provider, leave out the bookmark support described in "Adding Bookmark Support to the Consumer" and skip to "Adding XML Support to the Consumer."  
+> To build a consumer application to test Provider, leave out the bookmark support described in "Adding Bookmark Support to the Consumer" and skip to "Adding XML Support to the Consumer."  
   
 ## Retrieving Data with the Consumer  
 
-#### To modify the console application to use the OLE DB consumer  
+### To modify the console application to use the OLE DB consumer  
 
 1. In MyCons.cpp, change the main code by inserting the bold text as follows:  
 
@@ -82,9 +82,9 @@ The previous steps give you bookmark support and a bookmark object with which to
 - Output the bookmarked row, appending it to the end of the file.  
 
 > [!NOTE]
->  If you use this consumer application to test the Provider sample provider application, leave out the bookmark support described in this section.  
+> If you use this consumer application to test the Provider sample provider application, leave out the bookmark support described in this section.  
   
-#### To instantiate the bookmark  
+### To instantiate the bookmark  
 
 1. The accessor needs to contain an object of type [CBookmark](../../data/oledb/cbookmark-class.md). The *nSize* parameter specifies the size of the bookmark buffer in bytes (typically 4 for 32-bit platforms and 8 for 64-bit platforms). Add the following declaration to the column data members in the user record class:  
 
@@ -99,7 +99,7 @@ The previous steps give you bookmark support and a bookmark object with which to
        ...  
     ```  
 
-#### To request a bookmark column from the provider  
+### To request a bookmark column from the provider  
 
 1. Add the following code in the `GetRowsetProperties` method in the user record class:  
 
@@ -113,7 +113,7 @@ The previous steps give you bookmark support and a bookmark object with which to
     }  
     ```  
 
-#### To add a bookmark entry to the column map  
+### To add a bookmark entry to the column map  
 
 1. Add the following entry to the column map in the user record class:  
 
@@ -127,7 +127,7 @@ The previous steps give you bookmark support and a bookmark object with which to
     END_COLUMN_MAP()  
     ```  
 
-#### To use a bookmark in your main code  
+### To use a bookmark in your main code  
 
 1. In the MyCons.cpp file from the console application you previously created, change the main code to read as follows. To use bookmarks, the main code needs to instantiate its own bookmark object (`myBookmark`); this is a different bookmark from the one in the accessor (`m_bookmark`).  
 
@@ -172,7 +172,7 @@ The previous steps give you bookmark support and a bookmark object with which to
        {  
           nCounter++;  
           if(nCounter == 5 )  
-             myBookmark = rs.bookmark;  
+             myBookmark = rs.m_bookmark;  
           // Output the column information for each row:  
           outfile << rs.m_ProductID << rs.m_ProductName << lPrice << rs.m_QuantityPerUnit << rs.m_UnitsInStock << rs.m_ReorderLevel << endl;  
           hr = rs.MoveNext();  
@@ -204,15 +204,15 @@ For more information about bookmarks, see [Using Bookmarks](../../data/oledb/usi
 
 As discussed in [Accessing XML Data](../../data/oledb/accessing-xml-data.md), there are two ways to retrieve XML data from a data source: using [CStreamRowset](../../data/oledb/cstreamrowset-class.md) or using [CXMLAccessor](../../data/oledb/cxmlaccessor-class.md). This example uses `CStreamRowset`, which is more efficient, but requires you to have SQL Server 2000 running on the computer on which you execute this sample application.  
 
-#### To modify the command class to inherit from CStreamRowset  
+### To modify the command class to inherit from CStreamRowset  
 
 1. In the consumer application you previously created, change your `CCommand` declaration to specify `CStreamRowset` as the rowset class as follows:  
 
     ```cpp  
     class CProducts : public CCommand<CAccessor<CProductsAccessor>, CStreamRowset >  
     ```  
 
-#### To modify the main code to retrieve and output the XML data  
+### To modify the main code to retrieve and output the XML data  
 
 1. In the MyCons.cpp file from the console application you previously created, change the main code to read as follows: