GetFieldData, fonction (wdbgexts.h)

La fonction GetFieldData retourne la valeur d’un membre dans une structure.

Syntaxe

ULONG GetFieldData(
  [in]  ULONG64 TypeAddress,
  [in]  LPCSTR  Type,
  [in]  LPCSTR  Field,
  [in]  ULONG   OutSize,
  [out] PVOID   pOutValue
);

Paramètres

[in] TypeAddress

Spécifie l’adresse de la structure dans la mémoire de la cible.

[in] Type

Spécifie le nom du type de la structure. Cela peut être qualifié avec un nom de module, par exemple , mymodule !mystruct.

[in] Field

Spécifie le nom du membre dans la structure dont la valeur sera retournée. Les sous-membres peuvent être spécifiés à l’aide d’un chemin d’accès séparé par des points, par exemple, « myfield.mysubfield ».

Si la taille de la structure pointée par TypeAddress est inférieure à 8 octets, Field peut être NULL ; dans ce cas, la structure entière est copiée dans pOutValue.

[in] OutSize

Spécifie la taille, en octets, de la mémoire tampon pOutValue.

Si OutSize est inférieur à la taille de la valeur retournée, un message d’erreur est imprimé et une exception est levée ; si l’exception est gérée ou ignorée, la valeur de retour est zéro. Dans ce cas, les données situées au-delà de la fin de la mémoire tampon référencée par pOutValue peuvent être remplacées.

[out] pOutValue

Reçoit la valeur du membre. Ou, la valeur du type, si Field a la valeur NULL.

Valeur retournée

Si la fonction aboutit, la valeur de retour est égale à zéro. Sinon, la valeur de retour est un code d’erreur IG_DUMP_SYMBOL_INFO.

Configuration requise