Méthode IDebugSymbols3 ::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 La mémoire tampon 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 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 de 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.