Fonction QueryFullProcessImageNameA (winbase.h)

  • Article

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

Syntaxe

BOOL QueryFullProcessImageNameA(
  [in]      HANDLE hProcess,
  [in]      DWORD  dwFlags,
  [out]     LPSTR  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 Droits d’accès et de sécurité des processus.

[in] dwFlags

Ce paramètre peut prendre les valeurs suivantes.

Valeur Signification
0
 Le nom doit utiliser le format de chemin 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 se termine par un caractère 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 inclure 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 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 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