初始化和授权属性 (Native Client OLE DB Provider)
适用于：
SQL ServerAzure SQL 数据库Azure SQL 托管实例Azure Synapse AnalyticsAnalytics Platform System (PDW)
重要
已从 SQL Server 2022 (16.x) 和 SQL Server Management Studio 19 (SSMS) 中移除 SQL Server Native Client（通常缩写为 SNAC）。 不建议在新的开发工作中使用 SQL Server Native Client OLE DB 提供程序（SQLNCLI 或 SQLNCLI11）和旧版 Microsoft OLE DB Provider for SQL Server (SQLOLEDB)。 此后请切换到新的 Microsoft OLE DB Driver (MSOLEDBSQL) for SQL Server。
SQL Server Native Client OLE DB 访问接口解释 OLE DB 初始化和授权属性，如下所示：
| 属性 ID | 说明 |
|---|---|
| DBPROP_AUTH_CACHE_AUTHINFO | SQL Server Native Client OLE DB 访问接口不缓存身份验证信息。 SQL Server Native Client OLE DB 访问接口在尝试设置属性值时返回DB_S_ERRORSOCCURRED。 DBPROP 结构的 dwStatus 成员指示 DBPROPSTATUS_NOTSUPPORTED 。 |
| DBPROP_AUTH_ENCRYPT_PASSWORD | SQL Server Native Client OLE DB 提供程序使用标准的 Microsoft SQL Server 安全机制来隐藏密码。 SQL Server Native Client OLE DB 访问接口在尝试设置属性值时返回DB_S_ERRORSOCCURRED。 DBPROP 结构的 dwStatus 成员指示 DBPROPSTATUS_NOTSUPPORTED 。 |
| DBPROP_AUTH_INTEGRATED | 如果DBPROP_AUTH_INTEGRATED设置为 NULL 指针、null 字符串或“SSPI”VT_BSTR值，SQL Server Native Client OLE DB 提供程序使用 Windows 身份验证模式授权用户访问由DBPROP_INIT_DATASOURCE和DBPROP_INIT_CATALOG属性指定的SQL Server数据库。 如果它设置为 VT_EMPTY（默认值），则使用 SQL Server 安全机制。 SQL Server 登录和密码是在 DBPROP_AUTH_USERID 和 DBPROP_AUTH_PASSWORD 属性中指定的。 |
| DBPROP_AUTH_MASK_PASSWORD | SQL Server Native Client OLE DB 访问接口使用标准SQL Server安全机制来隐藏密码。 SQL Server Native Client OLE DB 访问接口在尝试设置属性值时返回DB_S_ERRORSOCCURRED。 DBPROP 结构的 dwStatus 成员指示 DBPROPSTATUS_NOTSUPPORTED 。 |
| DBPROP_AUTH_PASSWORD | 分配给 SQL Server 登录名的密码。 选用 SQL Server 身份验证来授权访问 SQL Server 数据库时，将使用该属性。 |
| DBPROP_AUTH_PERSIST_ENCRYPTED | SQL Server Native Client OLE DB 访问接口在保存时不会加密身份验证信息。 SQL Server Native Client OLE DB 访问接口在尝试设置属性值时返回DB_S_ERRORSOCCURRED。 DBPROP 结构的 dwStatus 成员指示 DBPROPSTATUS_NOTSUPPORTED 。 |
| DBPROP_AUTH_PERSIST_SENSITIVE_AUTHINFO | SQL Server Native Client OLE DB 访问接口会保留身份验证值，包括密码图像（如果请求这样做）。 不提供加密。 |
| DBPROP_AUTH_USERID | SQL Server 登录名。 选用 SQL Server 身份验证来授权访问 SQL Server 数据库时，将使用该属性。 |
| DBPROP_INIT_ASYNCH | SQL Server Native Client OLE DB 访问接口支持异步启动。 如果设置 DBPROP_INIT_ASYNCH 属性中的 DBPROPVAL_ASYNCH_INITIALIZE 位，将导致 IDBInitialize::Initialize 成为非阻止调用 。 有关详细信息，请参阅执行异步操作。 |
| DBPROP_INIT_CATALOG | 要连接的现有 SQL Server 数据库的名称。 |
| DBPROP_INIT_DATASOURCE | 运行 Microsoft SQL Server 实例的服务器的网络名称。 如果计算机上运行了 SQL Server 的多个实例，则需要按 \\ServerName\InstanceName 的形式指定 DBPROP_INIT_DATASOURCE 值，以连接到特定的 SQL Server 实例。 转义序列 \\ 用于表示反斜杠自身。 |
| DBPROP_INIT_GENERALTIMEOUT | 指明在多少秒后请求（数据源初始化和命令执行除外）超时。如果值为 0，则表示无限期超时。通过网络连接运行或用于分布式/事务方案的提供程序可以支持此属性，以建议登记的组件在遇到长时间运行的请求时触发超时。 数据源初始化和命令执行的超时仍分别由 DBPROP_INIT_TIMEOUT 和 DBPROP_COMMANDTIMEOUT 控制。 DBPROP_INIT_GENERALTIMEOUT 是只读的；如果尝试设置它，将返回 dwstatus 错误 DBPROPSTATUS_NOTSETTABLE 。 |
| DBPROP_INIT_HWND | 来自调用应用程序的 Windows 句柄。 如果允许提示用户输入初始化属性，则必须有有效的窗口句柄，才能显示初始化对话框。 |
| DBPROP_INIT_IMPERSONATION_LEVEL | SQL Server Native Client OLE DB 访问接口不支持模拟级别调整。 SQL Server Native Client OLE DB 访问接口在尝试设置属性值时返回DB_S_ERRORSOCCURRED。 DBPROP 结构的 dwStatus 成员指示 DBPROPSTATUS_NOTSUPPORTED 。 |
| DBPROP_INIT_LCID | SQL Server Native Client OLE DB 访问接口验证区域设置 ID，如果客户端上不支持或未安装区域设置 ID，则返回错误。 |
| DBPROP_INIT_LOCATION | SQL Server Native Client OLE DB 访问接口在尝试设置属性值时返回DB_S_ERRORSOCCURRED。 DBPROP 结构的 dwStatus 成员指示 DBPROPSTATUS_NOTSUPPORTED 。 |
| DBPROP_INIT_MODE | SQL Server Native Client OLE DB 访问接口在尝试设置属性值时返回DB_S_ERRORSOCCURRED。 DBPROP 结构的 dwStatus 成员指示 DBPROPSTATUS_NOTSUPPORTED 。 |
| DBPROP_INIT_PROMPT | SQL Server Native Client OLE DB 访问接口支持数据源初始化的所有提示模式。 SQL Server Native Client OLE DB 访问接口使用 DBPROMPT_NOPROMPT 作为属性的默认设置。 |
| DBPROP_INIT_PROTECTION_LEVEL | SQL Server Native Client OLE DB 访问接口不支持连接到 SQL Server 实例时的保护级别。 SQL Server Native Client OLE DB 访问接口在尝试设置属性值时返回DB_S_ERRORSOCCURRED。 DBPROP 结构的 dwStatus 成员指示 DBPROPSTATUS_NOTSUPPORTED 。 |
| DBPROP_INIT_PROVIDERSTRING | 请参阅本主题后面的 SQL Server Native Client OLE DB 访问接口字符串。 |
| DBPROP_INIT_TIMEOUT | 如果在指定的秒数内无法与 SQL Server 实例建立连接，则SQL Server Native Client OLE DB 访问接口在初始化时返回错误。 |
在特定于提供程序的属性集DBPROPSET_SQLSERVERDBINIT中，SQL Server Native Client OLE DB 访问接口定义这些附加的初始化属性。
| 属性 ID | 说明 |
|---|---|
| SSPROP_AUTH_OLD_PASSWORD | 键入：VT_BSTR R/W：写入 默认值：VT_EMPTY 说明:当前密码或已过期的密码。 有关详细信息，请参阅以编程方式更改密码。 |
| SSPROP_INIT_APPNAME | 键入：VT_BSTR R/W：读取/写入 说明:客户端应用程序名称。 |
| SSPROP_INIT_AUTOTRANSLATE | 键入：VT_BOOL R/W：读取/写入 默认值：VARIANT_TRUE 说明:OEM/ANSI 字符转换。 VARIANT_TRUE：SQL Server Native Client OLE DB 访问接口通过 Unicode 转换在客户端和服务器之间发送的 ANSI 字符串，以最大程度地减少在客户端和服务器上代码页之间匹配扩展字符时出现的问题： 对于发送到 SQL Serverchar、varchar 或 text 变量、参数或列实例的客户端 DBTYPE_STR 数据，它们先使用客户端 ANSI 代码页 (ACP) 从字符转换到 Unicode，再使用服务器的 ACP 从 Unicode 转换到字符 。 对于发送到客户端 DBTYPE_STR 变量的 SQL Server char、varchar 或 text 数据，它们使用服务器 ACP 从字符转换为 Unicode，再使用客户端 ACP 从 Unicode 转换为字符 。 这些转换由 SQL Server Native Client OLE DB 提供程序在客户端上执行。 这要求客户端上有在服务器上使用的同一 ACP。 这些设置对于为下面这些传输而发生的转换无效： 发送到服务器上的 char、varchar 或 text 的 Unicode DBTYPE_WSTR 客户端数据 。 发送到客户端上的 Unicode DBTYPE_WSTR 变量的 char、varchar 或 text 服务器数据 。 发送到服务器上的 Unicode nchar、nvarchar 或 ntext 的 ANSI DBTYPE_STR 客户端数据 。 发送到客户端上的 ANSI DBTYPE_STR 变量的 Unicode char、varchar 或 text 服务器数据 。 VARIANT_FALSE：SQL Server Native Client OLE DB 提供程序不执行字符转换。 SQL Server Native Client OLE DB 提供程序不会将客户端 ANSI 字符DBTYPE_STR发送到服务器上的 char、varchar 或文本变量、参数或列的数据进行转换。 对于从服务器发送到客户端上的 DBTYPE_STR 变量的 char、varchar 或 text 数据，不执行转换 。 如果客户端和 SQL Server 实例正在使用不同的 ACP，可能会错误地解释扩展字符。 |
| SSPROP_INIT_CURRENTLANGUAGE | 键入：VT_BSTR R/W：读取/写入 说明:SQL Server 语言名称。 标识用于系统消息选择和格式化的语言。 必须在运行 SQL Server 实例的计算机上安装该语言，否则数据源初始化将失败。 |
| SSPROP_INIT_DATATYPECOMPATIBILITY | 键入：VT_UI2 R/W：读取/写入 默认值：0 说明:在 SQL Server 和 ActiveX 数据对象 (ADO) 应用程序之间实现数据类型兼容。 如果使用默认值 0，则数据类型处理将默认采用由访问接口使用的方案。 如果使用值 80，则数据类型处理仅使用 SQL Server 2000 (8.x) 数据类型。 有关详细信息，请参阅将 ADO 与 SQL Server Native Client 配合使用。 |
| SSPROP_INIT_ENCRYPT | 键入：VT_BOOL R/W：读取/写入 默认值：VARIANT_FALSE 说明:若要加密通过网络传输的数据，应将 SSPROP_INIT_ENCRYPT 属性设置为 VARIANT_TRUE。 如果打开了“启用协议加密”，则不论 SSPROP_INIT_ENCRYPT 如何设置，始终都会进行加密。 如果将它关闭，并将 SSPROP_INIT_ENCRYPT 设置为 VARIANT_TRUE，那么将进行加密。 如果关闭“启用协议加密”，并将 SSPROP_INIT_ENCRYPT 设置为 VARIANT_FALSE，那么不进行加密。 |
| SSPROP_INIT_FAILOVERPARTNER | 键入：VT_BSTR R/W：读取/写入 说明:指定用于数据库镜像的故障转移伙伴的名称。 它是初始化属性，并且只能在初始化之前设置。 在初始化之后，它将返回由主服务器返回的故障转移伙伴（如果有）。 这允许智能应用程序缓存最新确定的备份服务器，但这样的应用程序应当知道，仅当初次建立（对于池连接则是重置）连接时该信息才会更新，因而在经过长时间的连接后可能会过时。 建立连接之后，应用程序可以查询该属性，以确定故障转移伙伴的标识。 如果主服务器没有故障转移伙伴，则此属性将返回空字符串。 有关详细信息，请参阅使用数据库镜像。 |
| SSPROP_INIT_FILENAME | 键入：VT_BSTR R/W：读取/写入 说明:指定可附加数据库的主文件名。 附加此数据库并使其成为连接的默认数据库。 若要使用 SSPROP_INIT_FILENAME，必须指定该数据库的名称作为初始化属性 DBPROP_INIT_CATALOG 的值。 如果该数据库名称不存在，它将查找在 SSPROP_INIT_FILENAME 中指定的主文件名，并使用在 DBPROP_INIT_CATALOG 中指定的名称来附加该数据库。 如果数据库是以前附加的，则 SQL Server 不重新附加它。 |
| SSPROP_INIT_MARSCONNECTION | 键入：VT_BOOL R/W：读取/写入 默认值：VARIANT_FALSE 说明:指定是否对连接启用多重活动结果集 (MARS)。 必须在与数据库建立连接之前将该选项设置为 true。 有关详细信息，请参阅使用多重活动结果集 (MARS)。 |
| SSPROP_INIT_NETWORKADDRESS | 键入：VT_BSTR R/W：读取/写入 说明:运行由 DBPROP_INIT_DATASOURCE 属性指定的 SQL Server 实例的服务器的网络地址。 |
| SSPROP_INIT_NETWORKLIBRARY | 键入：VT_BSTR R/W：读取/写入 说明:用于与 SQL Server 的实例通信的网络库 (DLL) 的名称。 该名称不应当包含路径或 .dll 文件扩展名。 可以使用 SQL Server 客户端配置实用工具来自定义其默认值。 注意：此属性仅支持 TCP 和 Named Pipes。 如果该属性在使用时带有前缀，最后将得到导致错误的双前缀，因为该属性用于在内部生成前缀。 |
| SSPROP_INIT_PACKETSIZE | 键入：VT_I4 R/W：读取/写入 说明：以字节为单位表示的网络数据包大小。 数据包大小属性值必须介于 512 和 32,767 之间。 默认SQL Server Native Client OLE DB 提供程序网络数据包大小为 4，096。 |
| SSPROP_INIT_TAGCOLUMNCOLLATION | 键入：BOOL R/W：写入 默认值：FALSE 说明:使用服务器端游标时，在数据库更新期间使用。 该属性用从服务器而不是客户端上的代码页获得的排序规则信息来标记数据。 当前，该属性仅供分布式查询进程使用，因为它知道目标数据的排序规则，并能正确转换它。 |
| SSPROP_INIT_TRUST_SERVER_CERTIFICATE | 键入：VT_BOOL R/W：读取/写入 默认值：VARIANT_FALSE 说明:用于启用或禁用服务器证书验证。 该属性是读/写属性，但在已建立连接之后尝试设置它将导致错误。 如果客户端配置为要求进行证书验证，则忽略该属性。 但是，应用程序可以将它与 SSPROP_INIT_ENCRYPT 一起使用，以保证即使将客户端配置为不要求加密，并且客户端上不提供证书，仍然会对应用程序与服务器之间的连接进行加密。 客户端应用程序可以在打开连接后查询此属性，以确定使用的实际加密和验证设置。 注意：在不进行证书验证的情况下使用加密可以针对数据包探查提供部分防护，但无法针对中间人攻击进行防护。 它只是允许对发送到服务器的登录名和数据进行加密，而无需验证服务器证书。 有关详细信息，请参阅使用加密但不验证。 |
| SSPROP_INIT_USEPROCFORPREP | 键入：VT_I4 R/W：读取/写入 默认值：SSPROPVAL_USEPROCFORPREP_ON 说明:SQL Server 存储过程的用法。 定义 SQL Server 临时存储过程的使用，以支持 ICommandPrepare 接口。 仅当连接到 SQL Server 6.5 时，该属性才有意义。 对于更高版本，将忽略该属性。 SSPROPVAL_USEPROCFORPREP_OFF：准备命令时，不创建临时存储过程。 SSPROPVAL_USEPROCFORPREP_ON：准备命令时，创建临时存储过程。 释放会话时，删除临时存储过程。 SSPROPVAL_USEPROCFORPREP_ON_DROP：准备命令时，创建临时存储过程。 使用 ICommandPrepare::Unprepare 撤销命令时，使用 ICommandText::SetCommandText 为命令对象指定新命令时，或释放对命令的所有应用程序引用时，删除该过程。 |
| SSPROP_INIT_WSID | 键入：VT_BSTR R/W：读取/写入 说明:用于标识工作站的字符串。 |
在特定于提供程序的属性集DBPROPSET_SQLSERVERDATASOURCEINFO中，SQL Server Native Client OLE DB 访问接口定义其他属性;有关详细信息，请参阅数据源信息属性。
SQL Server Native Client OLE DB 访问接口字符串
SQL Server Native Client OLE DB 访问接口在提供程序字符串属性值中识别类似于 ODBC 的语法。 在建立与 OLE DB 数据源的连接时，访问接口字符串属性将作为 OLE DB 初始化属性 DBPROP_INIT_PROVIDERSTRING 的值提供。 该属性指定在实现与 OLE DB 数据源的连接时所需的特定于 OLE DB 访问接口的连接数据。 在字符串中，各元素是使用分号分隔的。 字符串中的最后一个元素必须以分号结束。 每个元素均由一个关键字、一个等号字符和在初始化时传递的值组成。 例如：
Server=MyServer;UID=MyUserName;
使用 SQL Server Native Client OLE DB 提供程序时，使用者永远不需要使用提供程序字符串属性。 使用者可以使用 OLE DB 或SQL Server Native Client特定于 OLE DB 提供程序的初始化属性来设置提供程序字符串中反映的任何初始化属性。
有关 SQL Server Native Client OLE DB 访问接口中可用的关键字的列表，请参阅将连接字符串关键字与 SQL Server Native Client 配合使用。
另请参阅
反馈
即将发布：在整个 2024 年，我们将逐步淘汰作为内容反馈机制的“GitHub 问题”，并将其取代为新的反馈系统。 有关详细信息，请参阅：https://aka.ms/ContentUserFeedback。
提交和查看相关反馈