Funzione SetHandleInformation (handleapi.h)
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 |
|---|---|
|
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.
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 |