通过

  • 项目

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)。