OpenProcess, fonction (processthreadsapi.h)

Article
03/04/2024

Ouvre un objet de processus local existant.

Syntaxe

HANDLE OpenProcess(
  [in] DWORD dwDesiredAccess,
  [in] BOOL  bInheritHandle,
  [in] DWORD dwProcessId
);

Paramètres

[in] dwDesiredAccess

Accès à l’objet de processus. Ce droit d’accès est vérifié par rapport au descripteur de sécurité pour le processus. Ce paramètre peut être un ou plusieurs des droits d’accès au processus.

Si l’appelant a activé le privilège SeDebugPrivilege, l’accès demandé est accordé quel que soit le contenu du descripteur de sécurité.

[in] bInheritHandle

Si cette valeur est TRUE, les processus créés par ce processus héritent du handle. Sinon, les processus n’héritent pas de ce handle.

[in] dwProcessId

Identificateur du processus local à ouvrir.

Si le processus spécifié est le processus inactif système (0x00000000), la fonction échoue et le dernier code d’erreur est ERROR_INVALID_PARAMETER. Si le processus spécifié est le processus Système ou l’un des processus CSRSS (Client Server Run-Time Subsystem), cette fonction échoue et le dernier code d’erreur est ERROR_ACCESS_DENIED dû au fait que leurs restrictions d’accès empêchent le code utilisateur de les ouvrir.

Si vous utilisez GetCurrentProcessId comme argument de cette fonction, envisagez d’utiliser GetCurrentProcess au lieu d’OpenProcess pour améliorer les performances.

Valeur retournée

Si la fonction réussit, la valeur de retour est un handle ouvert pour le processus spécifié.

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

Remarques

Pour ouvrir un handle à un autre processus local et obtenir des droits d’accès complets, vous devez activer le privilège SeDebugPrivilege. Pour plus d’informations, consultez Modification des privilèges dans un jeton.

Le handle retourné par la fonction OpenProcess peut être utilisé dans n’importe quelle fonction qui nécessite un handle pour un processus, comme les fonctions d’attente, à condition que les droits d’accès appropriés aient été demandés.

Lorsque vous avez terminé avec le handle, veillez à le fermer à l’aide de la fonction CloseHandle .

Exemples

Pour obtenir un exemple, consultez Prise d’un instantané et Affichage des processus.

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