GetCurrentProcess
The GetCurrentProcess
function returns a pseudohandle for the current process.
HANDLE GetCurrentProcess(VOID)
Parameters
This function
has no parameters.
Return Values
The return
value is a pseudohandle to the current process.
Remarks
A pseudohandle
is a special constant that is interpreted as the current process handle. The
calling process can use this handle to specify its own process whenever a
process handle is required. Pseudohandles are not inherited by child processes.
This handle
has the maximum possible access to the process object. For systems that support
security descriptors, this is the maximum access allowed by the security
descriptor for the calling process. For systems that do not support security
descriptors, this is PROCESS_ALL_ACCESS. For more information, see Process
Objects.
A process can
create a real handle to itself that is valid in the context of other
processes, or that can be inherited by other processes, by specifying the
pseudohandle as the source handle in a call to the DuplicateHandle
function. A process can also use the OpenProcess function to open a real
handle to itself.
The
pseudohandle need not be closed when it is no longer needed. Calling the CloseHandle
function with a pseudohandle has no effect. If the pseudohandle is duplicated
by DuplicateHandle, the duplicate handle must be closed.
See Also