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 |