Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
Retrieves certain properties of an object handle.
Syntax
BOOL GetHandleInformation(
[in] HANDLE hObject,
[out] LPDWORD lpdwFlags
);
Parameters
[in] hObject
A handle to an object whose information is to be retrieved.
You can specify a handle to one of the following types of objects: access token, console input buffer, console screen buffer, event, file, file mapping, job, mailslot, mutex, pipe, printer, process, registry key, semaphore, serial communication device, socket, thread, or waitable timer.
[out] lpdwFlags
A pointer to a variable that receives a set of bit flags that specify properties of the object handle or 0. The following values are defined.
| Value | Meaning |
|---|---|
|
If this flag is set, a child process created with the bInheritHandles parameter of CreateProcess set to TRUE will inherit the object handle. |
|
If this flag is set, calling the CloseHandle function will not close the object handle. |
Return value
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.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows 2000 Professional [desktop apps only] |
| Minimum supported server | Windows 2000 Server [desktop apps only] |
| Target Platform | Windows |
| Header | handleapi.h (include Windows.h) |
| Library | Kernel32.lib |
| DLL | Kernel32.dll |