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 的詳細資訊，請參閱＜用戶端連接 (ODBC) 中的服務主要名稱 (SPN)＞。