RpcBindingInqAuthInfo 函式 (rpcdce.h)

發行項
08/25/2023

RpcBindingInqAuthInfo函式會從系結控制碼傳回驗證和授權資訊。

語法

RPC_STATUS RpcBindingInqAuthInfo(
  RPC_BINDING_HANDLE       Binding,
  RPC_CSTR                 *ServerPrincName,
  unsigned long            *AuthnLevel,
  unsigned long            *AuthnSvc,
  RPC_AUTH_IDENTITY_HANDLE *AuthIdentity,
  unsigned long            *AuthzSvc
);

參數

Binding

傳回驗證和授權資訊的伺服器系結控制碼。

ServerPrincName

傳回指向系 結中所參考之伺服器之預期主體名稱指標的指標。傳回的名稱及其語法的內容是由使用中的驗證服務所定義。

指定 Null 值以防止 RpcBindingInqAuthInfo 傳回 ServerPrincName 參數。在此情況下，應用程式不會呼叫 RpcStringFree 函式。

AuthnLevel

傳回指標，設定為用於使用 Binding進行遠端程序呼叫的驗證層級。請參閱附註。

指定 Null 值，以防止函式傳回 AuthnLevel 參數。

在 AuthnLevel參數中傳回的層級可能與呼叫RpcBindingSetAuthInfo函式時所指定的層級不同。當 RPC 執行時間程式庫不支援用戶端指定的驗證層級，並自動升級至下一個較高的驗證層級時，就會發生這種差異。

AuthnSvc

傳回指標設定為使用 Binding進行之遠端程序呼叫所指定的驗證服務。請參閱附註。

指定 Null 值以防止 RpcBindingInqAuthInfo 傳回 AuthnSvc 參數。

AuthIdentity

傳回資料結構控制碼的指標，其中包含針對使用 Binding進行之遠端程序呼叫所指定的用戶端驗證和授權認證。

指定 Null 值以防止 RpcBindingInqAuthInfo 傳回 AuthIdentity 參數。

AuthzSvc

傳回設定為用戶端應用程式在系 結上發出 遠端程序呼叫之授權服務的指標，請參閱附注。

指定 Null 值以防止 RpcBindingInqAuthInfo 傳回 AuthzSvc 參數。

注意如需 RPC 支援的驗證服務清單，請參閱 Authentication-Service 常數。

傳回值

值	意義
RPC_S_OK	呼叫成功。
RPC_S_INVALID_BINDING	系結控制碼無效。
RPC_S_WRONG_KIND_OF_BINDING	這是作業的系結錯誤種類。
RPC_BINDING_HAS_NO_AUTH	系結沒有驗證資訊。

注意如需有效錯誤碼的清單，請參閱 RPC 傳回值。

備註

用戶端應用程式會呼叫 RpcBindingInqAuthInfo 函式，以檢視與伺服器系結控制碼相關聯的驗證和授權資訊。 RpcBindingInqAuthInfoEx同樣地提供系結控制碼的安全性服務品質資訊。

RPC 執行時間程式庫會為傳回的 ServerPrincName 參數配置記憶體。應用程式負責呼叫傳回引數字串的 RpcStringFree 函式。

需求


最低支援的用戶端	Windows 2000 專業版 [傳統型應用程式 \|UWP 應用程式]
最低支援的伺服器	Windows 2000 Server [傳統型應用程式 \|UWP 應用程式]
目標平台	Windows
標頭	rpcdce.h (包含 Rpc.h)
程式庫	Rpcrt4.lib
Dll	Rpcrt4.dll