Freigeben über


GetFieldData-Funktion (wdbgexts.h)

Die GetFieldData-Funktion gibt den Wert eines Elements in einer Struktur zurück.

Syntax

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

Parameter

[in] TypeAddress

Gibt die Adresse der Struktur im Speicher des Ziels an.

[in] Type

Gibt den Namen des Typs der Struktur an. Dies kann mit einem Modulnamen, z. B. mymodule!mystruct, qualifiziert werden.

[in] Field

Gibt den Namen des Elements in der Struktur an, dessen Wert zurückgegeben wird. Untermembers können mithilfe eines periodentrennten Pfads angegeben werden, z. B. "myfield.mysubfield".

Wenn die Größe der Struktur, auf die von TypeAddress verwiesen wird, kleiner als 8 Bytes ist, kann FieldNULL sein. in diesem Fall wird die gesamte Struktur in pOutValue kopiert.

[in] OutSize

Gibt die Größe des Puffers pOutValue in Bytes an.

Wenn OutSize kleiner als die Größe des zurückgegebenen Werts ist, wird eine Fehlermeldung ausgegeben und eine Ausnahme ausgelöst. wenn die Ausnahme behandelt oder ignoriert wird, ist der Rückgabewert 0. In diesem Fall können die Daten über das Ende des Puffers hinaus, auf den pOutValue verweist, überschrieben werden.

[out] pOutValue

Empfängt den Wert des Elements. Oder der Wert des Typs, wenn FieldNULL ist.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert „0“. Andernfalls ist der Rückgabewert ein IG_DUMP_SYMBOL_INFO Fehlercode.

Anforderungen

Anforderung Wert
Zielplattform Desktop
Kopfzeile wdbgexts.h (einschließlich Wdbgexts.h, Dbgeng.h)