Fonction SetHandleInformation (handleapi.h)
Définit certaines propriétés d’un handle d’objet.
Syntaxe
BOOL SetHandleInformation(
[in] HANDLE hObject,
[in] DWORD dwMask,
[in] DWORD dwFlags
);
Paramètres
[in] hObject
Handle d’un objet dont les informations doivent être définies.
Vous pouvez spécifier un handle pour l’un des types d’objets suivants : jeton d’accès, mémoire tampon d’entrée de console, mémoire tampon d’écran de la console, événement, fichier, mappage de fichiers, travail, maillot, mutex, pipe, imprimante, processus, clé de Registre, sémaphore, périphérique de communication série, socket, thread ou minuteur d’attente.
[in] dwMask
Masque qui spécifie les indicateurs de bits à modifier. Utilisez les mêmes constantes que celles indiquées dans la description de dwFlags.
[in] dwFlags
Ensemble d’indicateurs de bits qui spécifie les propriétés du handle d’objet. Ce paramètre peut être égal à 0 ou à une ou plusieurs des valeurs suivantes.
| Valeur | Signification |
|---|---|
|
Si cet indicateur est défini, un processus enfant créé avec le paramètre bInheritHandles de CreateProcess défini sur TRUE héritera du handle d’objet. |
|
Si cet indicateur est défini, l’appel de la fonction CloseHandle ne ferme pas le handle d’objet. |
Valeur retournée
Si la fonction réussit, la valeur de retour est différente de zéro.
Si la fonction échoue, la valeur de retour est égale à zéro. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.
Notes
Pour définir ou effacer l’indicateur de bits associé dans dwFlags, vous devez définir un indicateur de bits de masque de modification dans dwMask.
Configuration requise
| Client minimal pris en charge | Windows 2000 Professionnel [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows 2000 Server [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | handleapi.h (inclure Windows.h) |
| Bibliothèque | Kernel32.lib |
| DLL | Kernel32.dll |