初始化和授权属性

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_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_PASSWORD

分配给 SQL Server 登录名的密码。选用 SQL Server 身份验证来授权访问 SQL Server 数据库时，将使用该属性。

DBPROP_AUTH_PERSIST_SENSITIVE_AUTHINFO

如果需要，SQL Server Native Client OLE DB 访问接口保存包括密码的图像在内的身份验证值。不提供加密。

DBPROP_INIT_ASYNCH

SQL Server Native Client OLE DB 访问接口支持异步启动。

如果设置 DBPROP_INIT_ASYNCH 属性中的 DBPROPVAL_ASYNCH_INITIALIZE 位，将导致 IDBInitialize::Initialize 成为非阻止调用。有关详细信息，请参阅执行异步操作。

DBPROP_INIT_DATASOURCE

运行 Microsoft SQL Server 实例的服务器的网络名称。如果有多个 SQL Server 实例运行于计算机上，则为了连接到特定的 SQL Server 实例，需要按 \\服务器名\实例名 的形式指定 DBPROP_INIT_DATASOURCE 值。转义序列 \\ 用于表示反斜杠自身。

DBPROP_INIT_HWND

来自调用应用程序的窗口句柄。如果允许提示用户输入初始化属性，则必须有有效的窗口句柄，才能显示初始化对话框。

DBPROP_INIT_LCID

SQL Server Native Client OLE DB 访问接口将验证区域设置 ID，如果区域设置 ID 不受支持或未安装在客户端上，它会返回错误。

DBPROP_INIT_MODE

SQL Server Native Client OLE DB 访问接口在尝试设置属性值时返回 DB_S_ERRORSOCCURRED。DBPROP 结构的 dwStatus 成员指示 DBPROPSTATUS_NOTSUPPORTED。

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_TIMEOUT

如果无法在指定的秒数内建立与 SQL Server 实例的连接，则 SQL Server Native Client OLE DB 访问接口将在初始化时返回错误。

SSPROP_AUTH_OLD_PASSWORD

类型：VT_BSTR

R/W：写

默认值：VT_EMPTY

说明：当前或过期的密码。有关详细信息，请参阅以编程方式更改密码。

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 Serverchar、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_DATATYPECOMPATIBILITY

类型：VT_UI2

R/W：读/写

默认值：0

说明：在 SQL Server 和 ActiveX 数据对象 (ADO) 应用程序之间实现数据类型兼容。如果使用默认值 0，则数据类型处理将默认采用由访问接口使用的方案。如果使用值 80，则数据类型处理仅使用 SQL Server 2000 数据类型。有关详细信息，请参阅将 ADO 用于 SQL Server Native Client。

SSPROP_INIT_FAILOVERPARTNER

类型：VT_BSTR

R/W：读/写

说明：指定用于数据库镜像的故障转移伙伴的名称。它是初始化属性，并且只能在初始化之前设置。在初始化之后，它将返回由主服务器返回的故障转移伙伴（如果有）。

这允许智能应用程序缓存最新确定的备份服务器，但这样的应用程序应当知道，仅当初次建立（对于池连接则是重置）连接时该信息才会更新，因而在经过长时间的连接后可能会过时。

建立连接之后，应用程序可以查询该属性，以确定故障转移伙伴的标识。如果主服务器没有故障转移伙伴，则该属性将返回空字符串。有关详细信息，请参阅使用数据库镜像。

SSPROP_INIT_MARSCONNECTION

类型：VT_BOOL

R/W：读/写

默认值：VARIANT_FALSE

说明：指定是否对连接启用多个活动结果集 (MARS)。必须在与数据库建立连接之前将该选项设置为 true。有关详细信息，请参阅使用多个活动的结果集 (MARS)。

SSPROP_INIT_NETWORKLIBRARY

类型：VT_BSTR

R/W：读/写

说明：用于与 SQL Server 实例通信的网络库 (DLL) 的名称。该名称不应当包含路径或 .dll 文件扩展名。

可以使用 SQL Server 客户端配置实用工具来自定义其默认值。

注意

该属性仅支持 TCP 和 Named Pipes。如果该属性在使用时带有前缀，最后将得到导致错误的双前缀，因为该属性用于在内部生成前缀。

SSPROP_INIT_TAGCOLUMNCOLLATION

类型：BOOL

R/W：写

默认值：FALSE

说明：使用服务器端游标时，在数据库更新期间使用。该属性用从服务器而不是客户端上的代码页获得的排序规则信息来标记数据。当前，该属性仅供分布式查询进程使用，因为它知道目标数据的排序规则，并能正确转换它。

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 为命令对象指定新命令时，或释放对命令的所有应用程序引用时，删除该过程。

注意

SQL Server Native Client OLE DB 访问接口不支持连接到 SQL Server 6.5 和更早版本。