SQL Server Native Client ODBC 驱动程序定义特定于驱动程序的连接属性。 某些属性可供使用 SQLGetConnectAttr，该函数用于报告其当前设置。 在建立连接或使用 SQLSetConnectAttr 设置属性之前，无法保证报告这些属性的值。
本主题列出只读属性。 有关其他 SQL Server Native Client ODBC 驱动程序特定连接属性的信息，请参阅 SQLSetConnectAttr。
SQL_COPT_SS_CONNECTION_DEAD
SQL_COPT_SS_CONNECTION_DEAD属性报告与服务器的连接状态。 驱动程序查询网络的当前连接状态。
注释
标准 ODBC 连接属性SQL_ATTR_CONNECTION_DEAD返回连接的最新状态。 这可能不是当前连接状态。
| 价值 | DESCRIPTION |
|---|---|
| SQL_CD_TRUE | 与服务器的连接已丢失。 |
| SQL_CD_FALSE | 连接已打开，可用于语句处理。 |
SQL_COPT_SS_CLIENT_CONNECTION_ID
SQL_COPT_SS_CLIENT_CONNECTION_ID属性检索客户端连接 ID，然后可用于查找：
启用时，XEvents 日志中的诊断信息。
连接环缓冲区中的连接错误信息。
启用时，数据访问跟踪日志中的诊断信息。
有关详细信息，请参阅 扩展事件日志中的访问诊断信息。
| 价值 | DESCRIPTION |
|---|---|
| SQL_ERROR | 连接失败。 |
| SQL_SUCCESS | 连接成功。 客户端连接 ID 将在输出缓冲区中找到。 |
SQL_COPT_SS_PERF_DATA
SQL_COPT_SS_PERF_DATA属性返回指向包含当前驱动程序性能统计信息的 SQLPERF 结构的指针。
SQLGetConnectAttr 如果未启用性能日志记录，将返回 NULL。 SQLPERF 结构中的统计信息不会由驱动程序动态更新。 每次需要刷新性能统计信息时调用 SQLGetConnectAttr 。
| 价值 | DESCRIPTION |
|---|---|
| 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 指针。
| 价值 | DESCRIPTION |
|---|---|
| SQL_UD_NOTSET | 未设置用户数据指针。 |
| 任何其他值 | 指向用户数据的指针。 |
SQLGetConnectAttr 对服务主体名称的支持 （SPN）
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 的详细信息，请参阅 客户端连接（ODBC）中的服务主体名称（SPN）。
另请参阅
SQLGetConnectAttr 函数
ODBC API 实现细节
SET QUOTED_IDENTIFIER（Transact-SQL）
SET ANSI_NULLS（Transact-SQL）
SET ANSI_PADDING （Transact-SQL）
SET ANSI_WARNINGS（Transact-SQL）