Metodo IDebugSymbols3::GetFieldName (dbgeng.h)

Articolo
08/07/2023

Il metodo GetFieldName restituisce il nome di un campo all'interno di una struttura.

Sintassi

HRESULT GetFieldName(
  [in]            ULONG64 Module,
  [in]            ULONG   TypeId,
  [in]            ULONG   FieldIndex,
  [out, optional] PSTR    NameBuffer,
  [in]            ULONG   NameBufferSize,
  [out, optional] PULONG  NameSize
);

Parametri

[in] Module

Specifica l'indirizzo di base del modulo in cui è stata definita la struttura.

[in] TypeId

Specifica l'ID del tipo della struttura.

[in] FieldIndex

Specifica l'indice del campo desiderato all'interno della struttura.

[out, optional] NameBuffer

Riceve il nome del campo. Se NameBuffer è NULL, queste informazioni non vengono restituite.

[in] NameBufferSize

Specifica le dimensioni in caratteri del buffer NameBuffer. Questa dimensione include lo spazio per il carattere di terminazione '\0'.

[out, optional] NameSize

Riceve le dimensioni in caratteri del nome del campo. Questa dimensione include lo spazio per il carattere di terminazione '\0'. Se NameSize è NULL, queste informazioni non vengono restituite.

Valore restituito

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

Codice restituito	Descrizione
S_OK	Il metodo è stato eseguito correttamente.
S_FALSE	Il metodo è stato eseguito correttamente. Tuttavia , NameBuffer non era sufficientemente grande da contenere il nome del campo e fu troncato.

Commenti

Per altre informazioni sui simboli, vedere Simboli.

Requisiti

Requisito	Valore
Piattaforma di destinazione	Desktop
Intestazione	dbgeng.h (include Dbgeng.h)