Funzione GetHandleInformation (handleapi.h)
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 |
|---|---|
|
Se questo flag è impostato, un processo figlio creato con il parametro bInheritHandles di CreateProcess impostato su TRUE erediterà l'handle dell'oggetto. |
|
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 |