SetHandleInformation
The SetHandleInformation
function sets certain properties of an object handle. The information is
specified as a set of bit flags.
BOOL SetHandleInformation (
|
HANDLE hObject, |
// handle to an
object |
|
DWORD dwMask, |
// specifies flags
to change |
|
DWORD dwFlags |
// specifies new
values for flags |
|
); |
|
Parameters
hObject
Specifies a
handle to an object. The SetHandleInformation function sets information
associated with this object handle.
dwMask
A mask that
specifies the bit flags to be changed. Use the same flag constants shown in the
description of dwFlags.
dwFlags
A set of bit
flags that specify properties of the object handle. The following flags are
defined:
|
Value |
Meaning |
|
HANDLE_FLAG_INHERIT |
If this
flag is set, a child process created with the bInheritHandles
parameter of CreateProcess
set to TRUE will inherit the object handle. |
|
HANDLE_FLAG_PROTECT_FROM_CLOSE |
If this
flag is set, calling the CloseHandle function will not close the object handle. |
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.
Remarks
Note that you
must set a change mask bit flag in dwMask in order to set or clear the
associated bit flag in dwFlags.
See Also