通过

初始化和授权属性 （Native Client OLE DB Provider）

  • 项目

适用于：SQL Server Azure SQL 数据库 Azure SQL 托管实例 Azure Synapse Analytics Analytics 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 字符串，以最大程度地减少客户端和服务器上的代码页之间匹配扩展字符的问题：

客户端DBTYPE_STR发送到 SQL Serverchar、 varchar 或 文本变量、参数或列实例的数据 使用客户端 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 访问接口不会转换发送到服务器上的 char、varchar 或文本变量、参数或列的客户端 ANSI 字符DBTYPE_STR数据。 对于从服务器发送到客户端上的 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 配合使用。

另请参阅

数据源对象 (OLE DB)