Méthode IDebugSymbols3 ::GetSymbolPath (dbgeng.h)

La méthode GetSymbolPath retourne le chemin du symbole.

Syntaxe

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

Paramètres

[out, optional] Buffer

Reçoit le chemin du symbole. Il s’agit d’une chaîne qui contient des éléments de chemin de symbole séparés par des points-virgules ( ;). Chaque élément de chemin de symbole peut spécifier un répertoire ou un serveur de symboles. 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 du symbole.

Valeur retournée

Ces méthodes peuvent é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 chemin du symbole et le chemin d’accès a été tronqué.

Remarques

Pour plus d’informations sur la manipulation du chemin des symboles, consultez Utilisation de symboles. Pour obtenir une vue d’ensemble du chemin du symbole et de sa syntaxe, consultez Chemin du symbole.

Configuration requise

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

Voir aussi

AppendSymbolPath

IDebugSymbols

IDebugSymbols2

IDebugSymbols3

SetSymbolPath