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

Article
02/23/2024

La méthode GetFieldOffset retourne le décalage d’un champ à partir de l’adresse de base d’un instance d’un type.

Syntaxe

HRESULT GetFieldOffset(
  [in]  ULONG64 Module,
  [in]  ULONG   TypeId,
  [in]  PCSTR   Field,
  [out] PULONG  Offset
);

Paramètres

[in] Module

Spécifie le module contenant les types du conteneur et du champ.

[in] TypeId

Spécifie l’ID de type du type contenant le champ.

[in] Field

Spécifie le nom du champ dont le décalage est demandé. Les sous-champs peuvent être spécifiés à l’aide d’un chemin d’accès séparé par des points.

[out] Offset

Reçoit le décalage du champ spécifié à partir de l’emplacement de mémoire de base d’un instance du type.

Valeur retournée

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

Code de retour	Description
S_OK	La méthode a réussi.
E_NOINTERFACE	Le champ Champ est introuvable dans le type spécifié par TypeId.

Remarques

Voici un exemple de chemin d’accès séparé par des points pour le paramètre Field . Supposons que la structure MyStruct contienne un champ MyField de type MySubStruct et que la structure MySubStruct contient le champ MySubField. Vous trouverez ensuite l’emplacement de ce champ par rapport à l’emplacement de la structure MyStruct en définissant le paramètre Field sur « MyField.MySubField ».

Pour plus d’informations sur les types, consultez Types.

Configuration requise

Condition requise	Valeur
Plateforme cible	Desktop (Expérience utilisateur)
En-tête	dbgeng.h (inclure Dbgeng.h)