Méthode IDebugSymbols3 ::GetSourceFileLineOffsetsWide (dbgeng.h)
La méthode GetSourceFileLineOffsetsWide mappe chaque ligne d’un fichier source à un emplacement dans la mémoire de la cible.
Syntaxe
HRESULT GetSourceFileLineOffsetsWide(
[in] PCWSTR 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 ne se trouve pas, le chemin d’accès est supprimé et les symboles sont interrogés à nouveau.
[out, optional] Buffer
Reçoit les emplacements dans 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 que 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 Mémoire tampon est définie sur DEBUG_INVALID_OFFSET. Si La mémoire tampon a la valeur NULL, ces informations ne sont pas retournées.
[in] BufferLines
Spécifie le nombre d’objets PULONG64 que le tableau tampon peut contenir.
[out, optional] FileLines
Reçoit le nombre de lignes dans le fichier source spécifié par File.
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 |
---|---|
|
La méthode a réussi. |
|
La méthode a réussi. Toutefois, le nombre de lignes dans le fichier source a dépassé le nombre d’entrées dans le tableau de mémoire tampon et certains des résultats ont été ignorés. |
Remarques
Pour plus d’informations sur l’utilisation du chemin d’accès source, consultez Utilisation de fichiers sources.
Configuration requise
Condition requise | Valeur |
---|---|
Plateforme cible | Desktop (Expérience utilisateur) |
En-tête | dbgeng.h (inclure Dbgeng.h) |