Condividi tramite

Funzione GetFieldData (wdbgexts.h)

  • Articolo

La funzione GetFieldData restituisce il valore di un membro in una struttura.

Sintassi

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

Parametri

[in] TypeAddress

Specifica l'indirizzo della struttura nella memoria della destinazione.

[in] Type

Specifica il nome del tipo della struttura. Può essere qualificato con un nome di modulo, ad esempio mymodule!mystruct.

[in] Field

Specifica il nome del membro nella struttura il cui valore verrà restituito. I membri secondari possono essere specificati usando un percorso separato da punti, ad esempio "myfield.mysubfield".

Se le dimensioni della struttura a cui punta TypeAddress sono inferiori a 8 byte, Field può essere NULL; in questo caso, l'intera struttura viene copiata in pOutValue.

[in] OutSize

Specifica le dimensioni, in byte, del valore pOutValue del buffer.

Se OutSize è minore delle dimensioni del valore restituito, viene stampato un messaggio di errore e viene generata un'eccezione; se l'eccezione viene gestita o ignorata, il valore restituito è zero. In questo caso, i dati oltre la fine del buffer a cui fa riferimento pOutValue potrebbero essere sovrascritti.

[out] pOutValue

Riceve il valore del membro. In alternativa, il valore del tipo, se Field è NULL.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è zero. In caso contrario, il valore restituito è un codice di errore IG_DUMP_SYMBOL_INFO.

Requisiti

Requisito Valore
Piattaforma di destinazione Desktop
Intestazione wdbgexts.h (include Wdbgexts.h, Dbgeng.h)