GetProcessId, fonction (processthreadsapi.h)

Récupère l’identificateur de processus du processus spécifié.

Syntaxe

DWORD GetProcessId(
  [in] HANDLE Process
);

Paramètres

[in] Process

Handle du processus. Le handle doit avoir le droit d’accès PROCESS_QUERY_INFORMATION ou PROCESS_QUERY_LIMITED_INFORMATION. Pour plus d’informations, consultez Droits d’accès et de sécurité des processus.

Windows Server 2003 et Windows XP : Le handle doit avoir le droit d’accès PROCESS_QUERY_INFORMATION.

Valeur retournée

Si la fonction réussit, la valeur de retour est l’identificateur du processus.

Si la fonction échoue, la valeur de retour est égale à zéro. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.

Remarques

Jusqu’à ce qu’un processus s’arrête, son identificateur de processus l’identifie de manière unique sur le système. Pour plus d’informations sur les droits d’accès, consultez Sécurité des processus et droits d’accès.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows Vista, Windows XP avec SP1 [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

Voir aussi

GetCurrentProcessId

GetProcessIdOfThread

GetThreadId

Processus