本主題描述在用戶端應用程式中支援服務主體名稱 （SPN） 的 ODBC 屬性和函式。 如需用戶端應用程式中SPN的詳細資訊，請參閱 用戶端連線中的服務主體名稱 （SPN） 支援 和 取得相互 Kerberos 驗證。
連接字串關鍵詞
下列連接字串關鍵字可讓用戶端應用程式指定SPN。
| 關鍵詞 | 價值觀 |
|---|---|
ServerSPN |
伺服器的 SPN。 默認值是空字串，導致 SQL Server Native Client 使用預設的驅動程式產生的 SPN。 |
FailoverPartnerSPN |
容錯移轉夥伴的 SPN。 默認值是空字串，導致 SQL Server Native Client 使用預設的驅動程式產生的 SPN。 |
連接屬性
下列連接屬性可讓用戶端應用程式指定SPN並查詢驗證方法。
| 名稱 | 類型 | 用法 |
|---|---|---|
| SQL_COPT_SS_SERVER_SPN SQL_COPT_SS_FAILOVER_PARTNER_SPN |
SQLTCHAR、讀取/寫入 | 指定伺服器的 SPN。 默認值是空字串，導致 SQL Server Native Client 使用預設的驅動程式產生的 SPN。 只有在以程式設計方式設定此屬性或開啟連接之後，才能查詢此屬性。 如果嘗試在未開啟且尚未以程式設計方式設定屬性的連線上查詢此屬性，則會傳回SQL_ERROR，且診斷記錄會記錄 SQLState 08003 和訊息「連線未開啟」。 如果在開啟連線時嘗試設定此屬性，則會傳回SQL_ERROR，並記錄診斷記錄與 SQLState HY011 和訊息「目前作業無效」。 |
| SQL_COPT_SS_INTEGRATED_AUTHENTICATION_METHOD | SQLTCHAR，唯讀 | 傳回連接所使用的驗證方法。 傳回給應用程式的值是 Windows 傳回 SQL Server Native Client 的值。 可能的值為： - “NTLM”，這是在使用 NTLM 驗證開啟連線時傳回的。 - “Kerberos”，這是在使用 Kerberos 驗證開啟連線時傳回的。 此屬性只能讀取使用 Windows 驗證的開啟連線。 如果在開啟連線之前嘗試讀取它，則會傳回SQL_ERROR，並記錄 SQLState 08003 和訊息「未開啟連線」的錯誤。 如果在未使用 Windows 驗證的連線上查詢這個屬性，則會傳回SQL_ERROR，而且會以 SQLState HY092 和訊息「無效的屬性/選項標識符（SQL_COPT_SS_INTEGRATED_AUTHENTICATION_METHOD僅適用於信任連線」訊息記錄錯誤。 如果無法判斷驗證方法，則會傳回SQL_ERROR，並使用 SQLState HY000 和訊息「一般錯誤」記錄錯誤。 |
| SQL_COPT_SS_MUTUALLY_AUTHENTICATED | SQLSMALLINT，唯讀 | 如果連接中的伺服器已相互驗證，則傳回SQL_TRUE;否則，會傳回 SQL_FALSE。 此屬性只能讀取開啟的連接。 如果在開啟連線之前嘗試讀取它，則會傳回SQL_ERROR，並記錄 SQLState 08003 和訊息「未開啟連線」的錯誤。 如果針對未使用 Windows 驗證的連線查詢這個屬性，則會傳回SQL_FALSE。 |
指定 SPN 的 ODBC 函數支援
下列 ODBC 函式支援用戶端應用程式和 SPN：