IDebugSymbols2::GetSourceFileLineOffsets, méthode (dbgeng.h)

La méthode GetSourceFileLineOffsets mappe chaque ligne d’un fichier source à un emplacement dans la mémoire de la cible.

Syntaxe

HRESULT GetSourceFileLineOffsets(
  [in]            PCSTR    File,
  [out, optional] PULONG64 Buffer,
  [in]            ULONG    BufferLines,
  [out, optional] PULONG   FileLines
);

Paramètres

[in] File

Spécifie le nom du fichier dont les lignes seront transformées en emplacements dans la mémoire de la cible. Les symboles de chaque module de la cible sont interrogés pour ce fichier. Si le fichier n’est pas situé, le chemin d’accès est supprimé et les symboles sont interrogés à nouveau.

[out, optional] Buffer

Reçoit les emplacements de la mémoire de la cible qui correspondent aux lignes du code source. La première entrée retournée à ce tableau correspond à la première ligne du fichier, de sorte qu’elle Buffer[i] contient l’emplacement de la ligne i+1. Si aucune information de symbole n’est disponible pour une ligne, l’entrée correspondante dans la mémoire tampon est définie sur DEBUG_INVALID_OFFSET. Si la mémoire tampon est NULL, ces informations ne sont pas retournées.

[in] BufferLines

Spécifie le nombre d’objets PULONG64 que le tableau de mémoires tampons peut contenir.

[out, optional] FileLines

Reçoit le nombre de lignes du fichier source spécifié par fichier.

Valeur de retour

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, le nombre de lignes du fichier source a dépassé le nombre d’entrées dans le tableau de mémoires tampons et certains des résultats ont été ignorés.

Remarques

Pour plus d’informations sur l’utilisation du chemin source, consultez Utilisation des fichiers sources.

Configuration requise

   
Plateforme cible Desktop (Expérience utilisateur)
En-tête dbgeng.h (include Dbgeng.h)

Voir aussi

FindSourceFile

GetSourceEntriesByLine

IDebugSymbols

IDebugSymbols2

IDebugSymbols3