RpcBindingInqAuthInfoExA 函式 （rpcdce.h）
RpcBindingInqAuthInfoEx 函式會從系結句柄傳回驗證、授權和安全性服務質量資訊。
語法
RPC_STATUS RpcBindingInqAuthInfoExA(
RPC_BINDING_HANDLE Binding,
RPC_CSTR *ServerPrincName,
unsigned long *AuthnLevel,
unsigned long *AuthnSvc,
RPC_AUTH_IDENTITY_HANDLE *AuthIdentity,
unsigned long *AuthzSvc,
unsigned long RpcQosVersion,
RPC_SECURITY_QOS *SecurityQOS
);
參數
Binding
傳回驗證和授權資訊的伺服器系結句柄。
ServerPrincName
傳回指向 Binding中所參考之伺服器之預期主體名稱的指標。 傳回的名稱及其語法的內容是由使用中的驗證服務所定義。
指定 null 值以防止 RpcBindingInqAuthInfoEx 傳回 ServerPrincName 參數。 在此情況下，應用程式不會呼叫 RpcStringFree 函式。
AuthnLevel
傳回指標，設定為用於使用系結 系結進行遠端過程調用的驗證層級。 如需 RPC 支援的驗證層級清單，請參閱 Authentication-Level 常數。 指定 null 值，以防止函式傳回 AuthnLevel 參數。
在 AuthnLevel 參數中傳回的層級，可能與 呼叫 rpcBindingSetAuthInfoEx 函式時所指定的層級不同。 當 RPC 執行時間連結庫不支援用戶端指定的驗證層級，並自動升級至下一個較高的驗證層級時，就會發生這種差異。
AuthnSvc
傳回針對使用系結 系結所呼叫之遠端過程呼叫所指定的驗證服務的指標，。 如需 RPC 支援的驗證服務清單，請參閱 Authentication-Service 常數。
指定 null 值以防止 RpcBindingInqAuthInfoEx 傳回 AuthnSvc 參數。
AuthIdentity
傳回數據結構句柄的指標，其中包含針對使用系結 系結所指定遠程過程調用所指定的客戶端驗證和授權認證。
指定 null 值以防止 RpcBindingInqAuthInfoEx 傳回 AuthIdentity 參數。
AuthzSvc
傳回用戶端應用程式所要求之授權服務的指標，這個指標會在 Binding上呼叫遠端過程調用。 如需 RPC 支援的驗證服務清單，請參閱 Authentication-Service 常數。
指定 null 值以防止 RpcBindingInqAuthInfoEx 傳回 AuthzSvc 參數。
RpcQosVersion
傳遞目前版本的值（如果延伸模組已對這個函式進行延伸模組，則需要向前相容性）。 請一律將此參數設定為 RPC_C_SECURITY_QOS_VERSION。
SecurityQOS
傳回定義服務質量設定之 RPC_SECURITY_QOS 結構的指標。
傳回值
| 價值 | 意義 |
|---|---|
|
呼叫成功。 |
|
系結句柄無效。 |
|
這是作業的錯誤系結類型。 |
|
系結沒有驗證資訊。 |
言論
用戶端應用程式會呼叫 RpcBindingInqAuthInfoEx 函式，以檢視與伺服器系結句柄相關聯的驗證和授權資訊。 此函式可讓您查詢系結句柄上的安全性服務品質。 否則，它與 RpcBindingInqAuthInfo相同。
RPC 執行時間連結庫會配置傳回 ServerPrincName 參數的記憶體。 應用程式負責呼叫傳回自變數字串的 RpcStringFree 函式。
注意
rpcdce.h 標頭會根據 UNICODE 預處理器常數的定義，將 RpcBindingInqAuthInfoEx 定義為自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。 如需詳細資訊，請參閱函式原型的
要求
| 要求 | 價值 |
|---|---|
| 最低支援的用戶端 | Windows 2000 專業版 [傳統型應用程式 |UWP 應用程式] |
| 支援的最低伺服器 | Windows 2000 Server [傳統型應用程式 |UWP 應用程式] |
| 目標平臺 | 窗戶 |
| 標頭 | rpcdce.h （包括 Rpc.h） |
| 連結庫 | Rpcrt4.lib |
| DLL | Rpcrt4.dll |