Funzione GetHandleInformation (handleapi.h)

  • Articolo

Recupera determinate proprietà di un handle di oggetto.

Sintassi

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

Parametri

[in] hObject

Handle per un oggetto le cui informazioni devono essere recuperate.

È possibile specificare un handle per uno dei tipi di oggetti seguenti: token di accesso, buffer di input della console, buffer dello schermo della console, evento, file, mapping di file, processo, mailslot, mutex, pipe, stampante, processo, chiave del Registro di sistema, semaforo, dispositivo di comunicazione seriale, socket, thread o timer waitable.

[out] lpdwFlags

Puntatore a una variabile che riceve un set di flag di bit che specificano le proprietà dell'handle dell'oggetto o 0. Vengono definiti i valori seguenti.

Valore Significato
HANDLE_FLAG_INHERIT
0x00000001
 Se questo flag è impostato, un processo figlio creato con il parametro bInheritHandles di CreateProcess impostato su TRUE erediterà l'handle dell'oggetto.
HANDLE_FLAG_PROTECT_FROM_CLOSE
0x00000002
 Se questo flag è impostato, la chiamata alla funzione CloseHandle non chiuderà l'handle dell'oggetto.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è diverso da zero.

Se la funzione ha esito negativo, il valore restituito è zero. Per informazioni dettagliate sull'errore, chiamare GetLastError.

Requisiti

Requisito Valore
Client minimo supportato Windows 2000 Professional [solo app desktop]
Server minimo supportato Windows 2000 Server [solo app desktop]
Piattaforma di destinazione Windows
Intestazione handleapi.h (include Windows.h)
Libreria Kernel32.lib
DLL Kernel32.dll

Vedere anche

Closehandle

CreateProcess

Funzioni handle e oggetti

SetHandleInformation