共用方式為

RpcBindingInqAuthClientExW 函式 (rpcdce.h)

  • 發行項

伺服器應用程式會呼叫 RpcBindingInqAuthClientEx 函式，以取得進行遠端過程調用之用戶端程式擴充的資訊。

語法

RPC_STATUS RpcBindingInqAuthClientExW(
  RPC_BINDING_HANDLE ClientBinding,
  RPC_AUTHZ_HANDLE   *Privs,
  RPC_WSTR           *ServerPrincName,
  unsigned long      *AuthnLevel,
  unsigned long      *AuthnSvc,
  unsigned long      *AuthzSvc,
  unsigned long      Flags
);

參數

ClientBinding

進行遠端過程調用之用戶端的用戶端系結句柄。 此值可以是零。 請參閱＜備註＞。

Privs

針對在 ClientBinding 系結句柄上進行遠端過程調用的用戶端應用程式，傳回具有特殊許可權資訊的句柄指標。 針對 ncalrpc 呼叫， Privs 包含具有客戶端主體名稱的字串。

伺服器應用程式必須將 Privs 參數轉換成 AuthnSvc 參數所指定的數據類型。 這個自變數所參考的數據是唯讀的，伺服器應用程式不應修改。 如果伺服器想要保留任何傳回的數據，伺服器必須將數據複製到伺服器配置的記憶體中。

如需 SSP 的詳細資訊，請參閱 安全性支援提供者 (SSP) 。

ServerPrincName

傳回指標，指向呼叫 RpcServerRegisterAuthInfo 函式的伺服器應用程式所指定的伺服器主體名稱指標。 傳回的名稱及其語法的內容是由使用中的驗證服務所定義。 針對 SCHANNEL SSP，主體名稱的格式為 msstd。 如需 msstd 格式的詳細資訊，請參閱 主體名稱。

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

AuthnLevel

傳回指標，設定為用戶端應用程式在 ClientBinding 系結句柄上發出遠端過程調用的驗證層級。 如需 RPC 支援的驗證層級清單，請參閱 驗證層級常數。

指定 Null 值以防止 RpcBindingInqAuthClientEx 傳回 AuthnLevel 參數。

AuthnSvc

傳回用戶端應用程式所要求之驗證服務的指標，這個指標會在 ClientBinding 系結句柄上呼叫遠端過程。 如需 RPC 支援的驗證服務清單，請參閱 Authentication-Service 常數。

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

注意AuthnSvc 會對應至每個憑證型 SSP 上 QueryContextAttributes 針對SECPKG_ATTR_DCE_INFO或SECPKG_ATTR_REMOTE_CERT_CONTEXT所傳回的SECURITY_STATUS。
 

AuthzSvc

傳回用戶端應用程式所要求的授權服務的指標，這個指標會在 系結系 結句柄上呼叫遠程過程。 如需 RPC 支援的授權服務清單，請參閱 Authorization-Service 常數 。

指定 Null 值以防止 RpcBindingInqAuthClientEx 傳回 AuthzSvc 參數。 RPC_C_AUTHN_WINNT驗證服務不會使用此參數。 傳回的值一律會RPC_S_AUTHZ_NONE。

Flags

控制主體名稱的格式。 此參數可以設定為下列值。

值 意義
RPC_C_FULL_CERT_CHAIN
 以 完整 格式傳回主體名稱。

傳回值

值 意義
RPC_S_OK
 呼叫成功。
RPC_S_INVALID_BINDING
 系結句柄無效。
RPC_S_WRONG_KIND_OF_BINDING
 這是作業的系結錯誤種類。
RPC_S_BINDING_HAS_NO_AUTH
 系結沒有驗證資訊。
 
注意 如需有效錯誤碼的清單，請參閱 RPC 傳回值。
 

備註

伺服器應用程式會呼叫 RpcBindingInqAuthClientEx 函式，以取得進行遠端過程調用之已驗證客戶端的主體名稱或許可權屬性。 此外， RpcBindingInqAuthClientEx 會傳回用戶端所指定的驗證服務、驗證層級和伺服器主體名稱。 伺服器可以使用傳回的數據進行授權。

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

針對同步 RPC 呼叫，伺服器應用程式可以使用零做為 ClientBinding 參數的值。 使用零會從目前正在執行的遠端過程調用擷取驗證和授權資訊。

注意

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

規格需求

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

另請參閱

RpcBindingInqAuthClient

RpcBindingSetAuthInfo

RpcStringFree