Función GetHandleInformation (handleapi.h)

Recupera ciertas propiedades de un identificador de objeto.

Sintaxis

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

Parámetros

[in] hObject

Identificador de un objeto cuya información se va a recuperar.

Puede especificar un identificador para uno de los siguientes tipos de objetos: token de acceso, búfer de entrada de consola, búfer de pantalla de consola, evento, archivo, asignación de archivos, trabajo, mailslot, exclusión mutua, tubería, impresora, proceso, clave del Registro, semáforo, dispositivo de comunicación serie, socket, subproceso o temporizador que pueda esperar.

[out] lpdwFlags

Puntero a una variable que recibe un conjunto de marcas de bits que especifican las propiedades del identificador de objeto o 0. Se definen los valores siguientes.

Valor	Significado
HANDLE_FLAG_INHERIT 0x00000001	Si se establece esta marca, un proceso secundario creado con el parámetro bInheritHandles de CreateProcess establecido en TRUE heredará el identificador de objeto.
HANDLE_FLAG_PROTECT_FROM_CLOSE 0x00000002	Si se establece esta marca, llamar a la función CloseHandle no cerrará el identificador del objeto.

Valor devuelto

Si la función se realiza correctamente, el valor devuelto es distinto de cero.

Si la función no se realiza correctamente, el valor devuelto es cero. Para obtener información de error extendida, llame a GetLastError.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	handleapi.h (incluya Windows.h)
Library	Kernel32.lib
Archivo DLL	Kernel32.dll

Vea también

CloseHandle

CreateProcess

Funciones de identificador y objeto

SetHandleInformation