ImpersonateNamedPipeClient
The ImpersonateNamedPipeClient
function impersonates a named-pipe client application.
BOOL ImpersonateNamedPipeClient(
|
HANDLE hNamedPipe |
// handle of a
named pipe |
|
); |
|
Parameters
hNamedPipe
Identifies a
named pipe.
Return Values
If the
function succeeds, the return value is nonzero.
If the
function fails, the return value is zero. To get extended error information,
call GetLastError
function.
Remarks
The ImpersonateNamedPipeClient
function allows the server end of a named pipe to impersonate the client end.
When this function is called, the named-pipe file system changes the thread of
the calling process to start impersonating the security context of the last
message read from the pipe. Only the server end of the pipe can call this
function.
The server
can call the RevertToSelf function when the impersonation is complete.
See Also