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
傳回指向系 結中所參考之伺服器之預期主體名稱指標的指標。 傳回的名稱及其語法的內容是由使用中的驗證服務所定義。
指定 Null 值以防止 RpcBindingInqAuthInfoEx 傳回 ServerPrincName 參數。 在此情況下，應用程式不會呼叫 RpcStringFree 函式。
AuthnLevel
傳回指標，設定為用於使用 Binding進行遠端程序呼叫的驗證層級。 如需 RPC 支援的驗證層級清單，請參閱 驗證層級常數。 指定 Null 值，以防止函式傳回 AuthnLevel 參數。
在 AuthnLevel參數中傳回的層級可能與呼叫RpcBindingSetAuthInfoEx函式時所指定的層級不同。 當 RPC 執行時間程式庫不支援用戶端指定的驗證層級，並自動升級至下一個較高的驗證層級時，就會發生這種差異。
AuthnSvc
傳回指標設定為使用 Binding進行之遠端程序呼叫所指定的驗證服務。 如需 RPC 支援的驗證服務清單，請參閱 Authentication-Service 常數。
指定 Null 值以防止 RpcBindingInqAuthInfoEx 傳回 AuthnSvc 參數。
AuthIdentity
傳回資料結構控制碼的指標，其中包含針對使用 Binding進行之遠端程序呼叫所指定的用戶端驗證和授權認證。
指定 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 應用程式] |
| 目標平台 | Windows |
| 標頭 | rpcdce.h (包含 Rpc.h) |
| 程式庫 | Rpcrt4.lib |
| Dll | Rpcrt4.dll |