rpcRevertToSelfEx 函式 (rpcdce.h)
RpcRevertToSelfEx函式可讓伺服器模擬用戶端,然後在多執行緒作業中還原,其中模擬用戶端的呼叫可能來自原本從 RPC 分派的執行緒以外的執行緒。
語法
RPC_STATUS RpcRevertToSelfEx(
RPC_BINDING_HANDLE BindingHandle
);
參數
BindingHandle
伺服器上的系結控制碼,表示與伺服器模擬之用戶端的系結。 值為零會指定目前線程的用戶端控制碼;在此情況下, RpcRevertToSelfEx 的功能與 RpcRevertToSelf 函式的功能相同。
傳回值
值 | 意義 |
---|---|
|
呼叫成功。 |
|
伺服器沒有要模擬的用戶端。 |
|
系結控制碼無效。 |
|
這是此作業的錯誤系結類型。 |
|
此作業系統、此傳輸或此安全性子系統不支援呼叫。 |
注意 如需有效錯誤碼的清單,請參閱 RPC 傳回值。
備註
呼叫 RpcImpersonateClient 並完成任何需要用戶端模擬的工作之後,伺服器會呼叫 RpcRevertToSelfEx 結束模擬,並重新建立自己的安全性身分識別。 例如,假設有一個稱為 thread1 的主要執行緒,它會從遠端用戶端分派,並喚醒稱為 thread2 的背景工作執行緒。 如果 thread2 要求伺服器模擬用戶端,伺服器會呼叫 RpcImpersonateClient (THREAD1_CALL_HANDLE) 、執行必要的工作、呼叫 RpcRevertToSelfEx (THREAD1_CALL_HANDLE) 結束模擬,然後喚醒 thread1。
需求
最低支援的用戶端 | Windows 2000 Professional [僅限傳統型應用程式] |
最低支援的伺服器 | Windows 2000 Server [僅限桌面應用程式] |
目標平台 | Windows |
標頭 | rpcdce.h (包含 Rpc.h) |
程式庫 | Rpcrt4.lib |
Dll | Rpcrt4.dll |