GetCurrentProcess, fonction (processthreadsapi.h)

Article
03/01/2024

Récupère un pseudo-handle pour le processus en cours.

Syntaxe

HANDLE GetCurrentProcess();

Valeur de retour

La valeur de retour est un pseudo handle du processus actuel.

Remarques

Un pseudo handle est une constante spéciale, actuellement (HANDLE)-1, qui est interprétée comme le handle de processus actuel. Pour la compatibilité avec les systèmes d’exploitation futurs, il est préférable d’appeler GetCurrentProcess au lieu de coder en dur cette valeur constante. Le processus appelant peut utiliser un pseudo-handle pour spécifier son propre processus chaque fois qu’un handle de processus est requis. Les pseudo-handles ne sont pas hérités par les processus enfants.

Ce handle a le droit d’accès PROCESS_ALL_ACCESS à l’objet de processus. Pour plus d’informations, consultez Traiter les droits de sécurité et d’accès.

Windows Server 2003 et Windows XP : Ce handle a l’accès maximal autorisé par le descripteur de sécurité du processus au jeton principal du processus.

Un processus peut créer un handle « réel » pour lui-même qui est valide dans le contexte d’autres processus ou qui peut être hérité par d’autres processus, en spécifiant le pseudo-handle comme handle source dans un appel à la fonction DuplicateHandle . Un processus peut également utiliser la fonction OpenProcess pour ouvrir un handle réel à lui-même.

Le pseudo-handle n’a pas besoin d’être fermé quand il n’est plus nécessaire. L’appel de la fonction CloseHandle avec un pseudo handle n’a aucun effet. Si le pseudo-handle est dupliqué par DuplicateHandle, le handle dupliqué doit être fermé.

Exemples

Pour obtenir un exemple, consultez Création d’un processus enfant avec une entrée et une sortie redirigées.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP [applications de bureau \| applications UWP]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau \| applications UWP]
Plateforme cible	Windows
En-tête	processthreadsapi.h (inclure Windows.h sur Windows Server 2003, Windows Vista, Windows 7, Windows Server 2008 Windows Server 2008 R2)
Bibliothèque	Kernel32.lib
DLL	Kernel32.dll