CoRevertToSelf

This function restores the authentication information on a thread of execution.

HRESULT CoRevertToSelf( )

Parameters

None.

Return Values

This function supports the standard return values, including the following values:

  • S_OK
    Indicates success.
  • RPC_E_CALL_COMPLETE
    Indicates failure. The current thread should be terminated.

Remarks

CoRevertToSelf, which is a helper function that calls IServerSecurity::RevertToSelf, restores the authentication information on a thread to the authentication information on the thread before impersonation began.

CoRevertToSelf encapsulates the following common sequence of calls (error handling excluded).

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

To determine whether the platform supports this function, see Determining Supported COM APIs.

Requirements

OS Versions: Windows CE 3.0 and later.
Header: Objbase.h.
Link Library: Ole32.lib.

See Also

CoGetCallContext

Last updated on Wednesday, April 13, 2005

© 2005 Microsoft Corporation. All rights reserved.