Función GetHandleInformation (handleapi.h)

  • Artículo

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