coImpersonateClient 函式 (combaseapi.h)

  • 發行項

讓伺服器在呼叫期間模擬目前呼叫的用戶端。

Syntax

HRESULT CoImpersonateClient();

傳回值

此函式支援標準傳回值，包括S_OK。

備註

這個方法可讓伺服器在呼叫期間模擬目前呼叫的用戶端。 如果您未呼叫 CoRevertToSelf，COM 會自動為您還原。 除非物件是以RPC_C_AUTHN_LEVEL_CONNECT或更高的驗證來呼叫，否則此函式將會失敗， (這是除了RPC_C_AUTHN_LEVEL_NONE) 以外的任何驗證層級。 此函式會封裝下列常見呼叫序列， (排除的錯誤處理) ：

    CoGetCallContext(IID_IServerSecurity, (void**)&pss);
    pss->ImpersonateClient();
    pss->Release();

CoImpersonateClient 會封裝取得 IServerSecurity 實例指標的程式，其中包含目前呼叫的相關資料、呼叫其 ImpersonateClient 方法，然後釋放指標。 CoRevertToSelf (或IServerSecurity：：RevertToSelf) 會復原任意數目的呼叫來模擬用戶端。

規格需求

   
最低支援的用戶端 Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限桌面應用程式]
目標平台 Windows
標頭 combaseapi.h (包含 Objbase.h)
程式庫 Ole32.lib
Dll Ole32.dll

另請參閱

隱形

IServerSecurity：：ImpersonateClient

模擬

模擬和非同步呼叫

COM 中的安全性