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
系結所參考之伺服器的預期主體名稱指標。 名稱和其語法的內容是由使用中的驗證服務所定義。
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 結構的指標,其定義安全性服務品質。
傳回值
值 | 意義 |
---|---|
|
呼叫成功。 |
|
系結句柄無效。 |
|
這是作業的系結錯誤種類。 |
|
未知的驗證服務。 |
備註
用戶端應用程式會呼叫 RpcBindingSetAuthInfoEx 函式,以設定伺服器系結句柄來進行已驗證的遠端過程調用。 此函式提供在系結句柄上設定安全性服務品質資訊的功能。 否則與 RpcBindingSetAuthInfo 相同。
除非用戶端呼叫 RpcBindingSetAuthInfoEx,否則系 結 上的所有遠端過程調用都會未經驗證。 不需要用戶端才能呼叫此函式。
RpcBindingSetAuthInfoEx 函式會擷取認證快照集。 因此, AuthIdentity 參數專用的記憶體可以在系結句柄之前釋放。 例外狀況是您的應用程式使用 RpcBindingSetAuthInfoEx 搭配 RPC_C_QOS_IDENTITY_DYNAMIC,也會指定 AuthIdentity 的非 NULL 值。
Windows Server 2003 SP1 和 Windows XP SP2: 針對 Windows XP SP2 和 Windows Server 2003 SP1,系結句柄的存留期不需要維護 AuthIdentity 參數的指標。 只有在後續呼叫 RpcBindingInqAuthInfo 或 RpcBindingInqAuthInfoEx 時,才能維護此指標。
注意
rpcdce.h 標頭會根據 UNICODE 預處理器常數的定義,將 RpcBindingSetAuthInfoEx 定義為自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼,可能會導致編譯或運行時間錯誤不符。 如需詳細資訊,請參閱 函式原型的慣例。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows 2000 專業版 [傳統型應用程式 |UWP 應用程式] |
最低支援的伺服器 | Windows 2000 Server [傳統型應用程式 |UWP 應用程式] |
目標平台 | Windows |
標頭 | rpcdce.h (包含 Rpc.h) |
程式庫 | Rpcrt4.lib |
Dll | Rpcrt4.dll |