共用方式為

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

另請參閱

SQLGetConnectAttr 函數
ODBC API 實作詳細資料
SET QUOTED_IDENTIFIER (Transact-SQL)
SET ANSI_NULLS (Transact-SQL)
SET ANSI_PADDING (Transact-SQL)
SET ANSI_WARNINGS (Transact-SQL)