Share via

RpcBindingSetAuthInfoExA 函式 (rpcdce.h)

  • 發行項

RpcBindingSetAuthInfoEx 函式會設定系結句柄的驗證、授權和安全性服務質量資訊。

語法

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

參數

Binding

設定驗證和授權資訊的伺服器系結句柄。

ServerPrincName

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

注意 如需 SSP 的一組允許目標名稱，請參閱 InitializeSecurityContext 檔中的批注。
 

AuthnLevel

要對使用 Binding 進行遠端過程調用執行的驗證層級。 如需 RPC 支援的驗證層級清單，請參閱 驗證層級常數。

AuthnSvc

要使用的驗證服務。

指定RPC_C_AUTHN_NONE，以關閉使用 Binding 進行之遠端過程調用的驗證。

如果指定RPC_C_AUTHN_DEFAULT，RPC 運行時間連結庫會使用 RPC_C_AUTHN_WINNT 驗證服務來進行使用 Binding 進行遠端過程調用。

AuthIdentity

結構句柄，其中包含適用於所選驗證和授權服務的客戶端驗證和授權認證。

使用 RPC_C_AUTHN_WINNT 驗證服務 AuthIdentity 時，應該是 Rpcdce.h) 中所定義 之SEC_WINNT_AUTH_IDENTITY (結構的指標。 Kerberos 和交涉驗證服務也會使用 SEC_WINNT_AUTH_IDENTITY 結構。

指定 Null 值，以使用目前位址空間的安全性登入內容。 傳遞值RPC_C_NO_CREDENTIALS以使用匿名登入內容。 請注意，只有在選取RPC_C_AUTHN_GSS_SCHANNEL作為驗證服務時，RPC_C_NO_CREDENTIALS才有效。

AuthzSvc

伺服器針對感興趣的介面所實作的授權服務。 授權數據的有效性和信任性，就像任何應用程式數據一樣，取決於所選取的驗證服務和驗證層級。 使用RPC_C_AUTHN_WINNT驗證服務時，會忽略此參數。 請參閱附註。

SecurityQos

RPC_SECURITY_QOS 結構的指標，其定義安全性服務品質。

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

傳回值

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

備註

用戶端應用程式會呼叫 RpcBindingSetAuthInfoEx 函式，以設定伺服器系結句柄來進行已驗證的遠端過程調用。 此函式提供在系結句柄上設定安全性服務品質資訊的功能。 否則與 RpcBindingSetAuthInfo 相同。

除非用戶端呼叫 RpcBindingSetAuthInfoEx，否則系 結 上的所有遠端過程調用都會未經驗證。 不需要用戶端才能呼叫此函式。

RpcBindingSetAuthInfoEx 函式會擷取認證快照集。 因此， AuthIdentity 參數專用的記憶體可以在系結句柄之前釋放。 例外狀況是您的應用程式使用 RpcBindingSetAuthInfoEx 搭配 RPC_C_QOS_IDENTITY_DYNAMIC，也會指定 AuthIdentity 的非 NULL 值。

注意RpcBindingSetAuthInfo 函式不得在系結句柄上呼叫，而相同句柄上的 RPC 呼叫正在進行中。 這麼做會產生未定義的結果。
 
由於不同版本的 Microsoft RPC 需求不同，Microsoft 建議只要繫結句柄存在，應用程式就會維護 AuthIdentity 參數的指標。 這麼做會增加應用程式可移植性。

Windows Server 2003 SP1 和 Windows XP SP2： 針對 Windows XP SP2 和 Windows Server 2003 SP1，系結句柄的存留期不需要維護 AuthIdentity 參數的指標。 只有在後續呼叫 RpcBindingInqAuthInfo 或 RpcBindingInqAuthInfoEx 時，才能維護此指標。

注意ncalrpc 通訊協定序列僅支援RPC_C_AUTHN_WINNT，但支援相互驗證;透過 SecurityQOS 參數提供 SPN 並要求相互驗證，以達成此目的。
 

注意

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

規格需求

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

另請參閱

RPC_SECURITY_QOS

RpcBindingInqAuthInfoEx

RpcServerRegisterAuthInfo