Metodo IDebugSymbols3::GetFieldTypeAndOffset (dbgeng.h)

Articolo
02/06/2025

Il metodo GetFieldTypeAndOffset restituisce il tipo di un campo e il relativo offset all'interno di un contenitore.

Sintassi

HRESULT GetFieldTypeAndOffset(
  [in]            ULONG64 Module,
  [in]            ULONG   ContainerTypeId,
  [in]            PCSTR   Field,
  [out, optional] PULONG  FieldTypeId,
  [out, optional] PULONG  Offset
);

Parametri

[in] Module

Specifica il modulo contenente i tipi sia del contenitore che del campo.

[in] ContainerTypeId

Specifica l'ID del tipo per il tipo del contenitore. Esempi di contenitori includono strutture, unioni e classi.

[in] Field

Specifica il nome del campo il cui tipo e offset sono richiesti. È possibile specificare campi secondari usando un percorso delimitato da punti.

[out, optional] FieldTypeId

Riceve l'ID del tipo del campo.

[out, optional] Offset

Riceve l'offset del campo Field dalla posizione di memoria di base di un'istanza del contenitore.

Valore restituito

Questo metodo può anche restituire valori di errore. Per altri dettagli, vedere valori restituiti.

Codice restituito	Descrizione
S_OK	Il metodo ha avuto esito positivo.
E_NOINTERFACE	Impossibile trovare il campo campo nel tipo specificato da ContainerTypeId.

Osservazioni

Di seguito è riportato un esempio di percorso delimitato da punti per il parametro Field. Si supponga che la struttura MyStruct contenga un campo MyField di tipo MySubStruct e che la struttura MySubStruct contenga il campo MySubField. È quindi possibile trovare il tipo di questo campo e la relativa posizione rispetto alla posizione della struttura MyStruct passando "MyField.MySubField" come parametro Field a questo metodo.

Per altre informazioni sui tipi, vedere Types. Per altre informazioni sui simboli, vedere Simboli.