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

Article
02/26/2024

La méthode GetFieldTypeAndOffset retourne le type d’un champ et son décalage dans un conteneur.

Syntaxe

HRESULT GetFieldTypeAndOffset(
  [in]            ULONG64 Module,
  [in]            ULONG   ContainerTypeId,
  [in]            PCSTR   Field,
  [out, optional] PULONG  FieldTypeId,
  [out, optional] PULONG  Offset
);

Paramètres

[in] Module

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

[in] ContainerTypeId

Spécifie l’ID de type du conteneur. Les structures, les unions et les classes sont des exemples de conteneurs.

[in] Field

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

[out, optional] FieldTypeId

Reçoit l’ID de type du champ.

[out, optional] Offset

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

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 Field est introuvable dans le type spécifié par ContainerTypeId.

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. Ensuite, le type de ce champ et son emplacement par rapport à l’emplacement de la structure MyStruct peuvent être trouvés en passant « MyField.MySubField » comme paramètre Field à cette méthode.

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