The GetHandleInformation function obtains information about certain properties of an object handle. The information is obtained as a set of bit flags.
BOOL GetHandleInformation (
| HANDLE hObject, | // handle to an object |
| LPDWORD lpdwFlags | // points to variable to receive flags |
| ); |
Parameters
hObject
Specifies a handle to an object. The GetHandleInformation function obtains information about this object handle.
lpdwFlags
Points to a variable to receive 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.
See Also