共用方式為

RpcBindingInqAuthClientExA 函式 （rpcdce.h）

  • 發行項

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

語法

RPC_STATUS RpcBindingInqAuthClientExA(
  RPC_BINDING_HANDLE ClientBinding,
  RPC_AUTHZ_HANDLE   *Privs,
  RPC_CSTR           *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 支援的驗證層級清單，請參閱 Authentication-Level 常數。

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

AuthnSvc

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

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

NoteAuthnSvc 對應至每個憑證型 SSP SECPKG_ATTR_DCE_INFO 或 SECPKG_ATTR_REMOTE_CERT_CONTEXT QueryContextAttributes 所傳回的 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 Professional [僅限傳統型應用程式]
支援的最低伺服器 Windows 2000 Server [僅限傳統型應用程式]
目標平臺 窗戶
標頭 rpcdce.h （包括 Rpc.h）
連結庫 Rpcrt4.lib
DLL Rpcrt4.dll

另請參閱

RpcBindingInqAuthClient

RpcBindingSetAuthInfo

RpcStringFree