IDebugSymbols3 ::GetLineByOffset, méthode (dbgeng.h)

Article
02/06/2025

La méthode GetLineByOffset retourne le nom de fichier source et le numéro de ligne dans le fichier source d’une instruction dans la cible.

Syntaxe

HRESULT GetLineByOffset(
  [in]            ULONG64  Offset,
  [out, optional] PULONG   Line,
  [out, optional] PSTR     FileBuffer,
  [in]            ULONG    FileBufferSize,
  [out, optional] PULONG   FileSize,
  [out, optional] PULONG64 Displacement
);

Paramètres

[in] Offset

Spécifie l’emplacement dans l’espace d’adressage virtuel de la cible de l’instruction pour laquelle retourner le fichier source et le numéro de ligne.

[out, optional] Line

Reçoit le numéro de ligne dans le fichier source de l’instruction spécifiée par Offset. Si ligne est NULL, ces informations ne sont pas retournées.

[out, optional] FileBuffer

Reçoit le nom de fichier du fichier qui contient l’instruction spécifiée par Offset. Si FileBuffer est NULL, ces informations ne sont pas retournées.

[in] FileBufferSize

Spécifie la taille, en caractères, de la mémoire tampon FileBuffer.

[out, optional] FileSize

Spécifie la taille, en caractères, du nom de fichier source. Si FileSize est NULL, ces informations ne sont pas retournées.

[out, optional] Displacement

Reçoit la différence entre l’emplacement spécifié dans décalage et l’emplacement de la première instruction de la ligne retournée. Si de déplacement est NULL, ces informations ne sont pas retournées.

Valeur de retour

Cette méthode peut également retourner d’autres valeurs d’erreur. Pour plus d’informations, consultez valeurs de retour.

Retourner le code	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 suffisamment grande pour contenir le nom du fichier source et le nom a été tronqué.