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

Article
02/26/2024

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 Décalage. Si Line a la valeur NULL, ces informations ne sont pas retournées.

[out, optional] FileBuffer

Reçoit le nom du fichier qui contient l’instruction spécifiée par Offset. Si FileBuffer a la valeur 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 a la valeur 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 Déplacement a la valeur NULL, ces informations ne sont pas retournées.

Valeur retournée

Cette méthode peut également retourner d’autres 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 nom du fichier source et le nom a été tronqué.