GetHandleInformation, fonction (handleapi.h)
Récupère certaines propriétés d’un handle d’objet.
Syntaxe
BOOL GetHandleInformation(
[in] HANDLE hObject,
[out] LPDWORD lpdwFlags
);
Paramètres
[in] hObject
Handle d’un objet dont les informations doivent être récupérées.
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 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.
[out] lpdwFlags
Pointeur vers une variable qui reçoit un ensemble d’indicateurs de bits qui spécifient les propriétés du handle d’objet ou 0. Les valeurs suivantes sont définies.
| 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.
Configuration requise
| Condition requise | Valeur |
|---|---|
| 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 |