getHandleInformation 函数 (handleapi.h)

检索对象句柄的某些属性。

语法

BOOL GetHandleInformation(
  [in]  HANDLE  hObject,
  [out] LPDWORD lpdwFlags
);

[in] hObject

要检索其信息的对象的句柄。

可以指定以下对象类型之一的句柄：访问令牌、控制台输入缓冲区、控制台屏幕缓冲区、事件、文件、文件映射、作业、mailslot、互斥体、管道、打印机、进程、注册表项、信号灯、串行通信设备、套接字、线程或可等待计时器。

[out] lpdwFlags

指向变量的指针，该变量接收一组位标志，这些标志指定对象句柄或 0 的属性。定义了以下值。

值	含义
HANDLE_FLAG_INHERIT 0x00000001	如果设置了此标志，则使用 CreateProcess 的 bInheritHandles 参数设置为 TRUE 创建的子进程将继承对象句柄。
HANDLE_FLAG_PROTECT_FROM_CLOSE 0x00000002	如果设置了此标志，则调用 CloseHandle 函数不会关闭对象句柄。

如果该函数成功，则返回值为非零值。

如果函数失败，则返回值为零。要获得更多的错误信息，请调用 GetLastError。

要求	值
最低受支持的客户端	Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器	Windows 2000 Server [仅限桌面应用]
目标平台	Windows
标头	handleapi.h (包括 Windows.h)
Library	Kernel32.lib
DLL	Kernel32.dll