GetHandleInformation function (handleapi.h)
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 |