Méthode IDebugSymbols2 ::GetSourcePathElement (dbgeng.h)

Article
02/23/2024

La méthode GetSourcePathElement retourne un élément à partir du chemin d’accès source.

Syntaxe

HRESULT GetSourcePathElement(
  [in]            ULONG  Index,
  [out, optional] PSTR   Buffer,
  [in]            ULONG  BufferSize,
  [out, optional] PULONG ElementSize
);

Paramètres

[in] Index

Spécifie l’index de l’élément dans le chemin d’accès source qui sera retourné. Le chemin source est une chaîne qui contient des éléments séparés par des points-virgules (;). L’index du premier élément est égal à zéro.

[out, optional] Buffer

Reçoit l’élément de chemin d’accès source. Chaque élément de chemin d’accès source peut être un répertoire ou un serveur source. 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] ElementSize

Reçoit la taille, en caractères, de l’élément de chemin d’accès source.

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.
E_NOINTERFACE	Le chemin d’accès source contient moins d’éléments Index .

Remarques

Le chemin d’accès source est utilisé par le moteur lors de la recherche de fichiers sources.

Pour plus d’informations sur la manipulation du chemin source, consultez Utilisation de fichiers sources. Pour obtenir une vue d’ensemble du chemin source et de sa syntaxe, consultez Chemin d’accès source.