Partager via


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 est retournée. Les sous-membres peuvent être spécifiés à l’aide d’un chemin séparé par un point, par exemple « myfield.mysubfield ».

Si la taille de la structure pointée par TypeAddress est inférieure à 8 octets, champ 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 égale à zéro. Dans ce cas, les donné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 champ est NULL .

Valeur de retour

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

Exigences

Exigence Valeur
plateforme cible Bureau
d’en-tête wdbgexts.h (include Wdbgexts.h, Dbgeng.h)