Merge pull request #5336 from MicrosoftDocs/master

3/29 PM Publish

Author: v-alje

docs/ado/guide/appendixes/microsoft-ole-db-provider-for-sql-server.md

@@ -26,6 +26,8 @@ ms.workload: "Active"
 # Microsoft OLE DB Provider for SQL Server Overview
 The Microsoft OLE DB Provider for SQL Server, SQLOLEDB, allows ADO to access Microsoft SQL Server.
 
+**NOTE:**  It is not recommended to use this driver for new development. The new OLE DB provider is called the [Microsoft OLE DB Driver for SQL Server](../../../connect/oledb/oledb-driver-for-sql-server.md) (MSOLEDBSQL) which will be updated with the most recent server features going forward.
+
 ## Connection String Parameters
  To connect to this provider, set the *Provider* argument to the [ConnectionString](../../../ado/reference/ado-api/connectionstring-property-ado.md) property to:
 

docs/breadcrumb/toc.yml

@@ -106,6 +106,66 @@
           - name: Syntax
             href: /sql/odbc/reference/syntax/
             homepage: /sql/odbc/reference/syntax/odbc-reference
+      - name: OLE DB
+        href: /sql/connect/oledb/
+        homepage: /sql/connect/oledb/oledb-driver-for-sql-server-programming
+        items:
+        - name: Features
+          href: /sql/connect/oledb/features/
+          homepage: /sql/connect/oledb/features/oledb-driver-for-sql-server-features
+        - name: Applications
+          href: /sql/connect/oledb/applications/
+          homepage: /sql/connect/oledb/applications/building-applications-with-oledb-driver-for-sql-server
+        - name: OLE DB
+          href: /sql/connect/oledb/ole-db/
+          homepage: /sql/connect/oledb/ole-db/oledb-driver-for-sql-server-ole-db
+          items:
+          - name: Driver
+            href: /sql/connect/oledb/ole-db-driver/
+            homepage: /sql/connect/oledb/ole-db-driver/creating-a-oledb-driver-for-sql-server-application
+          - name: Data source objects
+            href: /sql/connect/oledb/ole-db-data-source-objects/
+            homepage: /sql/connect/oledb/ole-db-data-source-objects/data-source-objects-ole-db
+          - name: Commands
+            href: /sql/connect/oledb/ole-db-commands/
+            homepage: /sql/connect/oledb/ole-db-commands/commands
+          - name: Rowsets
+            href: /sql/connect/oledb/ole-db-rowsets/
+            homepage: /sql/connect/oledb/ole-db-rowsets/rowsets
+          - name: Blobs
+            href: /sql/connect/oledb/ole-db-blobs/
+            homepage: /sql/connect/oledb/ole-db-blobs/blobs-and-ole-objects
+          - name: Tables and indexes
+            href: /sql/connect/oledb/ole-db-tables-indexes/
+            homepage: /sql/connect/oledb/ole-db-tables-indexes/tables-and-indexes
+          - name: Data types
+            href: /sql/connect/oledb/ole-db-data-types/
+            homepage: /sql/connect/oledb/ole-db-data-types/data-types-ole-db
+          - name: Table valued parameters
+            href: /sql/connect/oledb/ole-db-table-valued-parameters/
+            homepage: /sql/connect/oledb/ole-db-table-valued-parameters/table-valued-parameters-ole-db
+          - name: Date time
+            href: /sql/connect/oledb/ole-db-date-time/
+            homepage: /sql/connect/oledb/ole-db-date-time/date-and-time-improvements-ole-db
+          - name: Transactions
+            href: /sql/connect/oledb/ole-db-transactions/
+            homepage: /sql/connect/oledb/ole-db-transactions/transactions
+          - name: Errors
+            href: /sql/connect/oledb/ole-db-errors/
+            homepage: /sql/connect/oledb/ole-db-errors/errors
+          - name: Interfaces
+            href: /sql/connect/oledb/ole-db-interfaces/
+            homepage: /sql/connect/oledb/ole-db-interfaces/oledb-driver-for-sql-server-ole-db-interfaces
+          - name: How to
+            href: /sql/connect/oledb/ole-db-how-to/
+            homepage: /sql/connect/oledb/ole-db-how-to/ole-db-how-to-topics
+            items:
+            - name: Results
+              href: /sql/connect/oledb/ole-db-how-to/results/
+              homepage: /sql/connect/oledb/ole-db-how-to/results/processing-results-how-to-topics-ole-db
+            - name: FileStream
+              href: /sql/connect/oledb/ole-db-how-to/filestream/
+              homepage: /sql/connect/oledb/ole-db-how-to/filestream/filestream-and-ole-db
       - name: PHP
         href: /sql/connect/php/
         homepage: /sql/connect/php/microsoft-php-driver-for-sql-server

docs/connect/TOC.md

@@ -6,6 +6,7 @@
 # [JDBC +](jdbc/microsoft-jdbc-driver-for-sql-server.md)
 # [Node.js +](node-js/node-js-driver-for-sql-server.md)
 # [ODBC +](odbc/microsoft-odbc-driver-for-sql-server.md)
+# [OLE DB +](oledb/oledb-driver-for-sql-server-programming.md)
 # [PHP +](php/microsoft-php-driver-for-sql-server.md)
 # [Python +](python/python-driver-for-sql-server.md)
 # [Ruby +](ruby/ruby-driver-for-sql-server.md)

docs/connect/oledb/TOC.md

@@ -0,0 +1,9 @@
+# [OLE DB Driver for SQL Server Programming](oledb-driver-for-sql-server-programming.md)
+# [Features +](../oledb/features/oledb-driver-for-sql-server-features.md)
+# [Applications +](../oledb/applications/building-applications-with-oledb-driver-for-sql-server.md)
+# [OLE DB +](../oledb/ole-db/oledb-driver-for-sql-server-ole-db.md)
+
+# [Finding More OLE DB Driver for SQL Server Information](finding-more-oledb-driver-for-sql-server-information.md)
+# [OLE DB Driver for SQL Server](oledb-driver-for-sql-server.md)
+# [System Requirements for OLE DB Driver for SQL Server](system-requirements-for-oledb-driver-for-sql-server.md)
+# [When to Use OLE DB Driver for SQL Server](when-to-use-oledb-driver-for-sql-server.md)

docs/connect/oledb/applications/TOC.md

@@ -0,0 +1,9 @@
+# [Building Applications with OLE DB Driver for SQL Server](building-applications-with-oledb-driver-for-sql-server.md)
+# [Components of OLE DB Driver for SQL Server](components-of-oledb-driver-for-sql-server.md)
+# [Installing OLE DB Driver for SQL Server](installing-oledb-driver-for-sql-server.md)
+# [Support Policies for OLE DB Driver for SQL Server](support-policies-for-oledb-driver-for-sql-server.md)
+# [Updating an Application from SQL Server 2005 Native Client](updating-an-application-from-sql-server-2005-native-client.md)
+# [Updating an Application to OLE DB Driver for SQL Server from MDAC](updating-an-application-to-oledb-driver-for-sql-server-from-mdac.md)
+# [Using ADO with OLE DB Driver for SQL Server](using-ado-with-oledb-driver-for-sql-server.md)
+# [Using Connection String Keywords with OLE DB Driver for SQL Server](using-connection-string-keywords-with-oledb-driver-for-sql-server.md)
+# [Using the OLE DB Driver for SQL Server Header and Library Files](using-the-oledb-driver-for-sql-server-header-and-library-files.md)

docs/connect/oledb/applications/building-applications-with-oledb-driver-for-sql-server.md

@@ -0,0 +1,58 @@
+---
+title: "Building Applications with OLE DB Driver for SQL Server | Microsoft Docs"
+description: "Building applications with OLE DB Driver for SQL Server"
+ms.custom: ""
+ms.date: "03/26/2018"
+ms.prod: "sql-non-specified"
+ms.prod_service: "database-engine, sql-database, sql-data-warehouse, pdw"
+ms.service: ""
+ms.component: "oledb|applications"
+ms.reviewer: ""
+ms.suite: "sql"
+ms.technology:
+  - "docset-sql-devref"
+ms.tgt_pltfrm: ""
+ms.topic: "reference"
+helpviewer_keywords:
+  - "data access [OLE DB Driver for SQL Server], building applications"
+  - "MSOLEDBSQL, building applications"
+  - "applications [OLE DB Driver for SQL Server]"
+  - "OLE DB Driver for SQL Server, building applications"
+author: "pmasl"
+ms.author: "Pedro.Lopes"
+manager: "jhubbard"
+ms.workload: "On Demand"
+---
+# Building Applications with OLE DB Driver for SQL Server
+[!INCLUDE[appliesto-ss-asdb-asdw-pdw-md](../../../includes/appliesto-ss-asdb-asdw-pdw-md.md)]
+
+  When developing an application that uses the OLE DB Driver for SQL Server library, there are a number of issues that come into play. The topics in this section discuss many of these issues including upgrading from MDAC to OLE DB Driver for SQL Server, using the OLE DB Driver for SQL Server header and library files, and an overview of the various connection strings that can be used with OLE DB Driver for SQL Server.  
+
+## In This Section  
+ [Installing OLE DB Driver for SQL Server](../../oledb/applications/installing-oledb-driver-for-sql-server.md)  
+ Discusses how OLE DB Driver for SQL Server is installed, the locations that various components are installed to, and how to uninstall OLE DB Driver for SQL Server.  
+
+ [Components of OLE DB Driver for SQL Server](../../oledb/applications/components-of-oledb-driver-for-sql-server.md)  
+ Discusses the components that make up OLE DB Driver for SQL Server including library, resource, help, and header files.  
+
+ [Using Connection String Keywords with OLE DB Driver for SQL Server](../../oledb/applications/using-connection-string-keywords-with-oledb-driver-for-sql-server.md)  
+ Discusses the various types of connection strings that can be used when connecting to a database through OLE DB Driver for SQL Server.  
+
+ [Using the OLE DB Driver for SQL Server Header and Library Files](../../oledb/applications/using-the-oledb-driver-for-sql-server-header-and-library-files.md)  
+ Discusses how to use the OLE DB Driver for SQL Server header and library files within an application.  
+
+ [Updating an Application to OLE DB Driver for SQL Server from MDAC](../../oledb/applications/updating-an-application-to-oledb-driver-for-sql-server-from-mdac.md)  
+ Discusses the differences between OLE DB Driver for SQL Server and MDAC and issues that should be considered when upgrading from MDAC to OLE DB Driver for SQL Server.  
+
+ [Updating an Application from SQL Server 2005 Native Client](../../oledb/applications/updating-an-application-from-sql-server-2005-native-client.md)  
+ Discusses issues that should be considered when upgrading from [!INCLUDE[ssVersion2005](../../../includes/ssversion2005-md.md)] Native Client to OLE DB Driver for SQL Server.  
+
+ [Using ADO with OLE DB Driver for SQL Server](../../oledb/applications/using-ado-with-oledb-driver-for-sql-server.md)  
+ Discusses how ADO can use OLE DB Driver for SQL Server to access and use [!INCLUDE[ssNoVersion](../../../includes/ssnoversion-md.md)] functionality.  
+
+ [Support Policies for OLE DB Driver for SQL Server](../../oledb/applications/support-policies-for-oledb-driver-for-sql-server.md)  
+ Discusses how various data-access components can be used with different versions of OLE DB Driver for SQL Server.  
+
+## See Also  
+ [OLE DB Driver for SQL Server Programming](../../oledb/oledb-driver-for-sql-server-programming.md)     
+ [OLE DB How-to Topics](../../oledb/ole-db-how-to/ole-db-how-to-topics.md)  

docs/connect/oledb/applications/components-of-oledb-driver-for-sql-server.md

@@ -0,0 +1,38 @@
+---
+title: "Components of OLE DB Driver for SQL Server | Microsoft Docs"
+description: "Components of OLE DB Driver for SQL Server"
+ms.custom: ""
+ms.date: "03/26/2018"
+ms.prod: "sql-non-specified"
+ms.prod_service: "database-engine, sql-database, sql-data-warehouse, pdw"
+ms.service: ""
+ms.component: "oledb|applications"
+ms.reviewer: ""
+ms.suite: "sql"
+ms.technology:
+  - "docset-sql-devref"
+ms.tgt_pltfrm: ""
+ms.topic: "reference"
+helpviewer_keywords:
+  - "data access [OLE DB Driver for SQL Server], components"
+  - "components [OLE DB Driver for SQL Server]"
+  - "MSOLEDBSQL, about OLE DB Driver for SQL Server"
+author: "pmasl"
+ms.author: "Pedro.Lopes"
+manager: "jhubbard"
+ms.workload: "Inactive"
+---
+# Components of OLE DB Driver for SQL Server
+[!INCLUDE[appliesto-ss-asdb-asdw-pdw-md](../../../includes/appliesto-ss-asdb-asdw-pdw-md.md)]
+
+  OLE DB Driver for SQL Server contains the following components:  
+
+|Component|Description|  
+|---------------|-----------------|  
+|msoledbsql.dll|The dynamic-link library (DLL) file that contains all of the OLE DB Driver for SQL Server functionality.|  
+|msoledbsqlr.rll|The accompanying resource file for the OLE DB Driver for SQL Server library.|   
+|msoledbsql.h|The OLE DB Driver for SQL Server header file that contains all of the new definitions needed in order to use OLE DB Driver for SQL Server. This header file replaces the sqloledb.h header file.<br /><br /> Note: You can reference msoledbsql.h and sqloledb.h in same program as long as sqloledb.h is defined first.|  
+|msoledbsql.lib|The library file needed to directly call the **bcp** utility functions that are part of the OLE DB Driver for SQL Server.<br /><br /> Note: If you do reference the msoledbsql.lib file in your programming code, you need to make sure that the msoledbsql.dll file is in your system path, and in the system path of the users that make use of your application.|  
+
+## See Also  
+ [Building Applications with OLE DB Driver for SQL Server](../../oledb/applications/building-applications-with-oledb-driver-for-sql-server.md)  

docs/connect/oledb/applications/index.md

@@ -0,0 +1,3 @@
+---
+redirect_url: /sql/connect/oledb/applications/building-applications-with-oledb-driver-for-sql-server
+---

docs/connect/oledb/applications/installing-oledb-driver-for-sql-server.md

@@ -0,0 +1,72 @@
+---
+title: "Installing OLE DB Driver for SQL Server | Microsoft Docs"
+description: "Installing and uninstalling OLE DB Driver for SQL Server"
+ms.custom: ""
+ms.date: "03/26/2018"
+ms.prod: "sql-non-specified"
+ms.prod_service: "database-engine, sql-database, sql-data-warehouse, pdw"
+ms.service: ""
+ms.component: "oledb|applications"
+ms.reviewer: ""
+ms.suite: "sql"
+ms.technology:
+  - "docset-sql-devref"
+ms.tgt_pltfrm: ""
+ms.topic: "reference"
+helpviewer_keywords:
+  - "OLE DB Driver for SQL Server, uninstalling"
+  - "MSOLEDBSQL, installing"
+  - "MSOLEDBSQL, uninstalling"
+  - "Setup [OLE DB Driver for SQL Server]"
+  - "uninstalling OLE DB Driver for SQL Server"
+  - "data access [OLE DB Driver for SQL Server], uninstalling OLE DB Driver for SQL Server"
+  - "installing OLE DB Driver for SQL Server"
+  - "OLE DB Driver for SQL Server, installing"
+  - "data access [OLE DB Driver for SQL Server], installing OLE DB Driver for SQL Server"
+  - "removing OLE DB Driver for SQL Server"
+author: "pmasl"
+ms.author: "Pedro.Lopes"
+manager: "jhubbard"
+ms.workload: "Active"
+---
+# Installing OLE DB Driver for SQL Server
+[!INCLUDE[appliesto-ss-asdb-asdw-pdw-md](../../../includes/appliesto-ss-asdb-asdw-pdw-md.md)]
+
+To install the OLE DB Driver for SQL Server you need msoledbsql.msi installer.
+Run the installer and make your preferred selections. The OLE DB Driver for SQL Server can be installed side-by-side with earlier versions of Microsoft OLE DB providers.
+
+To download the most recent version of the OLE DB Driver for SQL Server go to Microsoft Download Center.
+
+
+ The OLE DB Driver for SQL Server files (msoledbsql.dll, msoledbsqlr.rll) are installed to the following location:  
+
+ `%SYSTEMROOT%\system32\`  
+
+> [!NOTE]  
+>  All appropriate registry settings for the OLE DB Driver for SQL Server are made as part of the installation process.  
+
+ The OLE DB Driver for SQL Server header and library files (msoledbsql.h and msoledbsql.lib) are installed in the following location:  
+
+ `%PROGRAMFILES%\Microsoft SQL Server\Client SDK\OLEDB\180\SDK`  
+
+
+ You can distribute OLE DB Driver for SQL Server through msoledbsql.msi. You might have to install OLE DB Driver for SQL Server when you deploy an application. One way to install multiple packages in what seems to the user to be a single installation is to use chainer and bootstrapper technology. For more information, see [Authoring a Custom Bootstrapper Package for Visual Studio 2005](http://go.microsoft.com/fwlink/?LinkId=115667) and [Adding Custom Prerequisites](http://go.microsoft.com/fwlink/?LinkId=115668).  
+  
+The x64 msoledbsql.msi also installs the 32-bit version of OLE DB Driver for SQL Server. If your application targets a platform other than the one it was developed on, you can download versions of msoledbsql.msi for x64 and x86.
+
+ When you invoke msoledbsql.msi, only the client components are installed by default. The client components are are files that support running an application that was developed using OLE DB Driver for SQL Server. To also install the SDK components, specify `ADDLOCAL=All` on the command line. For example:  
+
+ `msiexec /i msoledbsql.msi ADDLOCAL=ALL APPGUID={0CC618CE-F36A-415E-84B4-FB1BFF6967E1}`  
+
+## Silent Install  
+ If you use the /passive, /qn, /qb, or /qr option with msiexec, you must also specify IACCEPTMSOLEDBSQLLICENSETERMS=YES, to explicitly indicate that you accept the terms of the end user license. This option must be specified in all capital letters.  
+
+## Uninstalling OLE DB Driver for SQL Server  
+ Because applications such as [!INCLUDE[ssNoVersion](../../../includes/ssnoversion-md.md)] server and the [!INCLUDE[ssNoVersion](../../../includes/ssnoversion-md.md)] tools depend on OLE DB Driver for SQL Server, it is important not to uninstall OLE DB Driver for SQL Server until all dependent applications are uninstalled. To provide users with a warning that your application depends on OLE DB Driver for SQL Server, use the APPGUID install option in your MSI, as follows:  
+
+ `msiexec /i msoledbsql.msi APPGUID={0CC618CE-F36A-415E-84B4-FB1BFF6967E1}`  
+
+ The value passed to APPGUID is your specific product code. A product code must be created when using Microsoft Installer to bundle your application setup program.  
+
+## See Also  
+ [Building Applications with OLE DB Driver for SQL Server](../../oledb/applications/building-applications-with-oledb-driver-for-sql-server.md)   

docs/connect/oledb/applications/support-policies-for-oledb-driver-for-sql-server.md

@@ -0,0 +1,47 @@
+---
+title: "Support Policies for OLE DB Driver for SQL Server | Microsoft Docs"
+description: "Support policies for OLE DB Driver for SQL Server"
+ms.date: "03/26/2018"
+ms.prod: "sql-non-specified"
+ms.prod_service: "database-engine, sql-database, sql-data-warehouse, pdw"
+ms.service: ""
+ms.component: "oledb|applications"
+ms.reviewer: ""
+ms.suite: "sql"
+ms.custom: ""
+ms.technology: 
+  - "docset-sql-devref"
+ms.tgt_pltfrm: ""
+ms.topic: "reference"
+author: "pmasl"
+ms.author: "Pedro.Lopes"
+manager: "jhubbard"
+ms.workload: "On Demand"
+---
+# Support Policies for OLE DB Driver for SQL Server
+[!INCLUDE[appliesto-ss-asdb-asdw-pdw-md](../../../includes/appliesto-ss-asdb-asdw-pdw-md.md)]
+
+  This article discusses how various data-access components can be used with OLE DB Driver for SQL Server.  
+
+## Server Support  
+ OLE DB Driver for SQL Server supports connections to [!INCLUDE[ssSQL11](../../../includes/sssql11-md.md)],  [!INCLUDE[ssSQL14](../../../includes/sssql14-md.md)],[!INCLUDE[ssSQL15](../../../includes/sssql15-md.md)],  [!INCLUDE[ssSQL17](../../../includes/sssql17-md.md)], and [!INCLUDE[ssSDSfull](../../../includes/sssdsfull-md.md)].
+
+## Supported Operating System Versions  
+ The following table lists which operating systems support OLE DB Driver for SQL Server.  
+
+|Supported operating systems|  
+|--------------------------------------|---------------------------------|   
+|Microsoft Windows 8.1<br /><br />Microsoft Windows 10<br /><br /> Microsoft Windows Server 2012<br /><br />Microsoft Windows Server 2012 R2<br /><br />Microsoft Windows Server 2016|  
+
+## ADO Support Policies  
+ ADO applications can use the SQLOLEDB OLE DB provider that is included with Windows if they do not require any of the features of [!INCLUDE[ssVersion2005](../../../includes/ssversion2005-md.md)] or later.  
+
+ ADO applications can use the OLE DB Driver for SQL Server, but if they do so they must specify `DataTypeCompatibility=80` in the connection strings. Only features from [!INCLUDE[ssVersion2005](../../../includes/ssversion2005-md.md)] are available when `DataTypeCompatibility=80` is present in the connection strings.  
+
+## OLE DB Support Policies  
+Applications can use the OLE DB provider (SQLOLEDB) included with the Windows operating system. 
+However, that is in maintenance mode and no longer updated. 
+You should use the OLE DB Driver for SQL Server (MSOLEDBSQL) instead.
+
+## See Also  
+ [Building Applications with OLE DB Driver for SQL Server](../../oledb/applications/building-applications-with-oledb-driver-for-sql-server.md)