Méthode IDebugSystemObjects3 ::GetCurrentProcessExecutableName (dbgeng.h)

Article
02/26/2024

La méthode GetCurrentProcessExecutableName retourne le nom du fichier exécutable chargé dans le processus actuel.

Syntaxe

HRESULT GetCurrentProcessExecutableName(
  [out, optional] PSTR   Buffer,
  [in]            ULONG  BufferSize,
  [out, optional] PULONG ExeSize
);

Paramètres

[out, optional] Buffer

Reçoit le nom du fichier exécutable. Si Buffer a la valeur NULL, ces informations ne sont pas retournées.

[in] BufferSize

Spécifie la taille en caractères de la mémoire tampon. Cette taille inclut l’espace pour le caractère de fin « \0 ».

[out, optional] ExeSize

Reçoit la taille en caractères du nom du fichier exécutable. Cette taille inclut l’espace pour le caractère de fin « \0 ». Si ExeSize a la valeur NULL, ces informations ne sont pas retournées.

Valeur retournée

Cette méthode peut également retourner des valeurs d’erreur. Pour plus d’informations, consultez Valeurs de retour.

Code de retour	Description
S_OK	La méthode a réussi.
S_FALSE	La méthode a réussi. Toutefois, la mémoire tampon n’était pas assez grande pour contenir le nom du fichier exécutable et elle a été tronquée.

Remarques

Ces méthodes sont disponibles uniquement dans le débogage en mode utilisateur.

Si le moteur ne peut pas déterminer le nom du fichier exécutable, il écrit la chaîne « ? » NoImage ? » dans la mémoire tampon.

Pour plus d’informations sur les processus, consultez Threads et processus.

Configuration requise

Condition requise	Valeur
Plateforme cible	Desktop (Expérience utilisateur)
En-tête	dbgeng.h (inclure Dbgeng.h)