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

Article
02/26/2024

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é. Le 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 a la valeur 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 pour le caractère de fin « \0 ».

[out, optional] NameSize

Reçoit la taille en caractères du nom du symbole. Cette taille inclut l’espace pour le caractère de fin « \0 ». Si NameSize a la valeur 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 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’étant pas assez grande pour contenir le nom du symbole, elle a été tronquée.
E_FAIL	Aucun symbole n’a pu être trouvé à l’emplacement spécifié.