RpcImpersonateClient
A server
thread that is processing client remote procedure calls can call the RpcImpersonateClient
function to impersonate the active client.
This function
is supported only by Windows NT.
#include <rpc.h>
RPC_STATUS RPC_ENTRY RpcImpersonateClient(
|
RPC_BINDING_HANDLE CallHandle |
|
|
); |
|
Parameters
CallHandle
Specifies a
binding handle on the server that represents a binding to a client. The server
impersonates the client indicated by this handle. If a value of zero is
specified, the server impersonates the client that is being served by this
server thread.
Return Values
|
Value |
Meaning |
|
RPC_S_OK |
Success. |
|
RPC_S_NO_CALL_ACTIVE |
No client
is active on this server thread. |
|
RPC_S_CANNOT_SUPPORT |
The
function is not supported for either the operating system, the transport, or
this security subsystem. |
|
RPC_S_INVALID_BINDING |
Invalid
binding handle. |
|
RPC_S_WRONG_KIND_OF_BINDING |
Wrong kind
of binding for operation. |
|
RPC_S_NO_CONTEXT_AVAILABLE |
The server
does not have permission to impersonate the client. |
Remarks
In a
multithreaded application, if the call to RpcImpersonateClient is with a
handle to another client thread, you must call RpcRevertToSelfEx with the handle to that
thread to end impersonation.
See Also