GetCurrentProcess, fonction (processthreadsapi.h)
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 |