Méthode IDebugSymbols3 ::GetNameByOffsetWide (dbgeng.h)
La méthode GetNameByOffsetWide retourne le nom du symbole à l’emplacement spécifié dans l’espace d’adressage virtuel de la cible.
Syntaxe
HRESULT GetNameByOffsetWide(
[in] ULONG64 Offset,
[out, optional] PWSTR 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 le symbole appartient (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 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 |
---|---|
|
La méthode a réussi. |
|
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. |
|
Aucun symbole n’est disponible à l’emplacement spécifié. |
Remarques
Pour plus d’informations sur les symboles et les noms de symboles, consultez Symboles.
Configuration requise
Condition requise | Valeur |
---|---|
Plateforme cible | Desktop (Expérience utilisateur) |
En-tête | dbgeng.h (inclure Dbgeng.h) |
Voir aussi
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour