Méthode IDebugSymbols ::GetImagePath (dbgeng.h)

Article
02/23/2024

La méthode GetImagePath retourne le chemin d’accès de l’image exécutable.

Syntaxe

HRESULT GetImagePath(
  [out, optional] PSTR   Buffer,
  [in]            ULONG  BufferSize,
  [out, optional] PULONG PathSize
);

Paramètres

[out, optional] Buffer

Reçoit le chemin d’accès de l’image exécutable. Il s’agit d’une chaîne qui contient des répertoires séparés par des points-virgules ( ;). 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 .

[out, optional] PathSize

Reçoit la taille, en caractères, du chemin d’accès de l’image exécutable.

Valeur retournée

Cette méthode peut également retourner d’autres 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 chemin d’accès de l’image exécutable et le chemin d’accès a été tronqué.

Remarques

Le chemin d’accès à l’image exécutable est utilisé par le moteur lors de la recherche d’images exécutables.

Le chemin d’accès à l’image exécutable peut se composer de plusieurs répertoires séparés par des points-virgules. Ces répertoires sont recherchés dans l’ordre.