適用於：
SQL ServerAzure SQL 資料庫Azure SQL 受控執行個體Azure Synapse Analytics
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屬性會擷取用戶端連線標識碼，然後可用來尋找：
啟用時，XEvents 記錄中的診斷資訊。
連接通道緩衝區中的連線錯誤資訊。
啟用時，數據存取追蹤記錄中的診斷資訊。
如需詳細資訊，請參閱 存取擴充事件記錄檔中的診斷資訊。
| 值 | Description |
|---|---|
| SQL_ERROR | 連接失敗。 |
| SQL_SUCCESS | 線上成功。 用戶端連線標識碼會在輸出緩衝區中找到。 |
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）。