Fonction QueryFullProcessImageNameA (winbase.h)
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 |
|---|---|
|
Le nom doit utiliser le format de chemin Win32. |
|
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 |