Fonction QueryFullProcessImageNameW (winbase.h)

Article
03/13/2024

Récupère le nom complet de l’image exécutable pour le processus spécifié.

Syntaxe

BOOL QueryFullProcessImageNameW(
  [in]      HANDLE hProcess,
  [in]      DWORD  dwFlags,
  [out]     LPWSTR lpExeName,
  [in, out] PDWORD lpdwSize
);

Paramètres

[in] hProcess

Handle du processus. Ce handle doit être créé avec le droit d’accès PROCESS_QUERY_INFORMATION ou PROCESS_QUERY_LIMITED_INFORMATION. Pour plus d’informations, consultez Traiter les droits de sécurité et d’accès.

[in] dwFlags

Ce paramètre peut prendre les valeurs suivantes.

Valeur	Signification
0	Le nom doit utiliser le format de chemin d’accès Win32.
PROCESS_NAME_NATIVE 0x00000001	Le nom doit utiliser le format de chemin d’accès système natif.

[out] lpExeName

Chemin d’accès à l’image exécutable. Si la fonction réussit, cette chaîne est terminée par null.

[in, out] lpdwSize

Lors de l’entrée, spécifie la taille de la mémoire tampon lpExeName , en caractères. En cas de réussite, reçoit le nombre de caractères écrits dans la mémoire tampon, sans compter le caractère de fin null.

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 compiler une application qui utilise cette fonction, définissez _WIN32_WINNT comme 0x0600 ou version ultérieure.

Notes

L’en-tête winbase.h définit QueryFullProcessImageName comme un alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. La combinaison de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	winbase.h (inclure Windows.h)
Bibliothèque	Kernel32.lib
DLL	Kernel32.dll

Voir aussi

GetModuleFileNameEx

GetProcessImageFileName

Fonctions de processus et de thread

Partager via