OpenProcessToken, fonction (processthreadsapi.h)

Article
08/25/2023

La fonction OpenProcessToken ouvre le jeton d’accès associé à un processus.

Syntaxe

BOOL OpenProcessToken(
  [in]  HANDLE  ProcessHandle,
  [in]  DWORD   DesiredAccess,
  [out] PHANDLE TokenHandle
);

Paramètres

[in] ProcessHandle

Handle du processus dont le jeton d’accès est ouvert. Le processus doit avoir l’autorisation d’accès PROCESS_QUERY_LIMITED_INFORMATION. Pour plus d’informations, consultez Droits d’accès et de sécurité des processus.

[in] DesiredAccess

Spécifie un masque d’accès qui spécifie les types d’accès demandés au jeton d’accès. Ces types d’accès demandés sont comparés à la liste de contrôle d’accès discrétionnaire (DACL) du jeton pour déterminer quels accès sont accordés ou refusés.

Pour obtenir la liste des droits d’accès pour les jetons d’accès, consultez Droits d’accès pour les objets Access-Token.

[out] TokenHandle

Pointeur vers un handle qui identifie le jeton d’accès nouvellement ouvert lorsque la fonction est retournée.

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.

Remarques

Pour obtenir un handle vers un processus avec élévation de privilèges à partir d’un processus non élevé, les deux processus doivent être démarrés à partir du même compte.

Si le processus en cours de vérification a été démarré par un autre compte, le privilège SE_DEBUG_NAME doit être activé pour le processus de vérification. Pour plus d’informations, consultez Constantes de privilège (autorisation).

Pour fermer le handle de jeton d’accès retourné via le paramètre TokenHandle , appelez CloseHandle.

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)
Bibliothèque	Advapi32.lib
DLL	Advapi32.dll