共用方式為

RpcBindingInqAuthInfoW 函式 (rpcdce.h)

  • 發行項

RpcBindingInqAuthInfo 函式會從系結句柄傳回驗證和授權資訊。

語法

RPC_STATUS RpcBindingInqAuthInfoW(
  RPC_BINDING_HANDLE       Binding,
  RPC_WSTR                 *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 函式。

注意

rpcdce.h 標頭會根據 UNICODE 預處理器常數的定義，將 RpcBindingInqAuthInfo 定義為自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。 如需詳細資訊，請參閱 函式原型的慣例。

規格需求

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

另請參閱

RpcBindingInqAuthClient

RpcBindingInqAuthInfoEx

RpcBindingInqOption

RpcBindingSetAuthInfo

RpcStringFree