SQLGetConnectAttr

SQL Server Native Client ODBC 驱动程序定义了特定于驱动程序的连接属性。一些属性对 SQLGetConnectAttr 可用,并且使用该函数报告其当前设置。直到已建立连接或已使用 SQLSetConnectAttr 设置属性之后,才能保证报告这些属性的值。

有关属性的详细信息,请参阅 SQLSetConnectAttr

SQL_COPT_SS_CONNECTION_DEAD

SQL_COPT_SS_CONNECTION_DEAD 属性报告与服务器的连接的状态。驱动程序将查询网络,以获得连接的当前状态。

注意注意

标准 ODBC 连接属性 SQL_ATTR_CONNECTION_DEAD 返回连接的最近状态。这可能不是当前连接状态。

说明

SQL_CD_TRUE

与服务器的连接已丢失。

SQL_CD_FALSE

连接已打开,可以用于执行语句处理。

SQL_COPT_SS_PERF_DATA

SQL_COPT_SS_PERF_DATA 属性返回包含当前驱动程序性能统计信息的 SQLPERF 结构的指针。如果不启用性能记录,SQLGetConnectAttr 将返回 NULL。驱动程序不会动态更新 SQLPERF 结构中的统计信息。每次需要刷新性能统计信息时,请调用 SQLGetConnectAttr

说明

NULL

未启用性能记录。

任何其他值

SQLPERF 结构的指针。

SQL_COPT_SS_PERF_QUERY

如果启用对长时间运行查询的记录,则 SQL_COPT_SS_PERF_QUERY 属性返回 TRUE。如果查询记录不处于活动状态,则请求返回 FALSE。

SQL_COPT_SS_USER_DATA

SQL_COPT_SS_USER_DATA 属性检索用户数据指针。用户数据存储在客户端拥有的内存中,并在每次连接时进行记录。如果尚未设置用户数据指针,则返回 SQL_UD_NOTSET(NULL 指针)。

说明

SQL_UD_NOTSET

未设置用户数据指针。

任何其他值

用户数据的指针。

对服务主体名称 (SPN) 的 SQLGetConnectAttr 支持

SQLGetConnectAttr 可以用于查询新连接属性 SQL_COPT_SS_SERVER_SPN、SQL_COPT_SS_FAILOVER_PARTNER_SPN、SQL_COPT_SS_MUTUALLY_AUTHENTICATED 和 SQL_COPT_SS_INTEGRATED_AUTHENTICATION_METHOD 的值。(SQLGetConnectOption 也可以用于查询这些值。)

SQL_COPT_SS_INTEGRATED_AUTHENTICATION_METHOD 仅对使用 Windows 身份验证的打开连接可用。

如果尚未设置 SQL_COPT_SS_SERVER_SPN 或 SQL_COPT_SS_FAILOVER_PARTNER,则返回默认值(空字符串)。

有关 SPN 的详细信息,请参阅客户端连接中的服务主体名称 (SPN) (ODBC)