通过

初始化和授权属性

  • 项目

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 实例运行于计算机上，则为了连接到特定的 SQL Server 实例，需要按 \\ServerName\InstanceName 的形式指定 DBPROP_INIT_DATASOURCE 值。 转义序列 \\ 用于表示反斜杠自身。

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 Server char、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 访问接口不转换发送到服务器上的 char、varchar 或 text 变量、参数或列的客户端 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 数据类型。 有关详细信息，请参阅将 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)