GetFieldValue-Makro (wdbgexts.h)
Das GetFieldValue Makros ist ein dünner Wrapper um die GetFieldData--Funktion. Es wird als Komfort zum Lesen des Werts eines Elements in einer Struktur bereitgestellt.
Syntax
void GetFieldValue(
Addr,
Type,
Field,
OutValue
);
Parameter
Addr
Gibt die Adresse der Struktur im Speicher des Ziels an.
Type
Gibt den Namen des Typs der Struktur an. Dies kann mit einem Modulnamen qualifiziert werden, z. B. mymodule!mystruct.
Field
Gibt den Namen des Elements in der Struktur an. Untermember können mithilfe eines punkttrennten Pfads angegeben werden, z. B. "myfield.mysubfield".
OutValue
Gibt das Objekt an, in das der Wert des Elements gelesen wird.
Rückgabewert
Nichts
Bemerkungen
Die parameter, die für dieses Makro bereitgestellt werden, sind identisch mit den Parametern, die für die GetFieldData--Funktion bereitgestellt werden, mit der Ausnahme, dass die Variable, die den zurückgegebenen Wert enthalten soll, direkt bereitgestellt werden kann, anstatt einen Zeiger auf einen Puffer und dessen Größe bereitzustellen.
Ertrag
Wenn die Funktion erfolgreich ist, ist der Rückgabewert null. Andernfalls ist der Rückgabewert einer der IG_DUMP_SYMBOL_INFO Fehlercode.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform- | Desktop |
| Header- | wdbgexts.h (include Wdbgexts.h, Dbgeng.h) |