共用方式為


SQLGetConnectAttr

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

請參閱

參考

SET QUOTED_IDENTIFIER (Transact-SQL)

SET ANSI_NULLS (Transact-SQL)

SET ANSI_PADDING (Transact-SQL)

SET ANSI_WARNINGS (Transact-SQL)

概念

ODBC API 實作詳細資料

其他資源

SQLGetConnectAttr 函數