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