SQLGetConnectAttr

發行項
05/07/2013

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 會傳回最新的連接狀態。這可能不是目前的連接狀態。

值	說明
SQL_CD_TRUE	已經遺失與伺服器的連接。
SQL_CD_FALSE	連接已開啟，而且可用來處理陳述式。

SQL_COPT_SS_CLIENT_CONNECTION_ID

SQL_COPT_SS_CLIENT_CONNECTION_ID 屬性擷取用戶端連接識別碼，然後可使用此識別碼尋找：

啟用之 XEvents 記錄檔中的診斷資訊。
連接信號緩衝區中的連接錯誤資訊。
啟用之資料存取追蹤記錄檔中的診斷資訊。

如需詳細資訊，請參閱＜存取擴展事件記錄檔中的診斷資訊＞。

值	說明
SQL_ERROR	連接失敗。
SQL_SUCCESS	此連接已成功。輸出緩衝區中將可以找到用戶端連接識別碼。

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

請參閱

共用方式為