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

Article
02/06/2025

La méthode GetNameByOffset retourne le nom du symbole à l’emplacement spécifié dans l’espace d’adressage virtuel de la cible.

Syntaxe

HRESULT GetNameByOffset(
  [in]            ULONG64  Offset,
  [out, optional] PSTR     NameBuffer,
  [in]            ULONG    NameBufferSize,
  [out, optional] PULONG   NameSize,
  [out, optional] PULONG64 Displacement
);

Paramètres

[in] Offset

Spécifie l’emplacement dans l’espace d’adressage virtuel de la cible du symbole dont le nom est demandé. décalage n’a pas besoin de spécifier l’emplacement de base du symbole ; il doit uniquement spécifier un emplacement dans l’allocation de mémoire du symbole.

[out, optional] NameBuffer

Reçoit le nom du symbole. Le nom est qualifié par le module auquel appartient le symbole (par exemple, mymodule !main). Si NameBuffer est NULL, ces informations ne sont pas retournées.

[in] NameBufferSize

Spécifie la taille en caractères de la mémoire tampon NameBuffer. Cette taille inclut l’espace du caractère de fin « \0 ».

[out, optional] NameSize

Reçoit la taille en caractères du nom du symbole. Cette taille inclut l’espace du caractère de fin « \0 ». Si NameSize est NULL, ces informations ne sont pas retournées.

[out, optional] Displacement

Reçoit la différence entre la valeur de Offset et l’emplacement de base du symbole. 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 assez grande pour contenir le nom du symbole, de sorte qu’elle a été tronquée.
E_FAIL	Aucun symbole n’est trouvé à l’emplacement spécifié.