Funzione SetHandleInformation (handleapi.h)

  • Articolo

Imposta determinate proprietà di un handle oggetto.

Sintassi

BOOL SetHandleInformation(
  [in] HANDLE hObject,
  [in] DWORD  dwMask,
  [in] DWORD  dwFlags
);

Parametri

[in] hObject

Handle a un oggetto le cui informazioni devono essere impostate.

È possibile specificare un handle a uno dei tipi di oggetti seguenti: token di accesso, buffer di input console, buffer dello schermo 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 attendebile.

[in] dwMask

Maschera che specifica i flag di bit da modificare. Usare le stesse costanti visualizzate nella descrizione di dwFlags.

[in] dwFlags

Set di flag di bit che specificano le proprietà dell'handle dell'oggetto. Questo parametro può essere 0 o uno o più dei 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.

Commenti

Per impostare o cancellare il flag di bit associato in dwFlags, è necessario impostare un flag di bit di maschera di modifica in dwMask.

Requisiti

   
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 (includere Windows.h)
Libreria Kernel32.lib
DLL Kernel32.dll

Vedere anche

Closehandle

CreateProcess

GetHandleInformation

Handle e Funzioni oggetto