Metodo IDebugSymbolGroup::GetSymbolName (dbgeng.h)

Articolo
02/25/2024

Il metodo GetSymbolName restituisce il nome di un simbolo in un gruppo di simboli.

Sintassi

HRESULT GetSymbolName(
  [in]            ULONG  Index,
  [out, optional] PSTR   Buffer,
  [in]            ULONG  BufferSize,
  [out, optional] PULONG NameSize
);

Parametri

[in] Index

Indice del simbolo di cui si desidera il nome. L'indice di un simbolo è un numero di identificazione. L'indice è compreso tra zero e il numero di simboli nel gruppo di simboli meno uno.

[out, optional] Buffer

Nome del simbolo. Se Buffer è NULL, queste informazioni non vengono restituite.

[in] BufferSize

Dimensioni del buffer a cui punta Buffer . Questa dimensione include lo spazio per il carattere di terminazione '\0'.

[out, optional] NameSize

Dimensione del nome del simbolo. Questa dimensione include lo spazio per il carattere di terminazione '\0'. Se NameSize è NULL, queste informazioni non vengono restituite.

Valore restituito

Codice restituito	Descrizione
S_OK	Il metodo è stato eseguito correttamente.
S_FALSE	Il metodo è stato eseguito correttamente. Tuttavia, il nome del simbolo non rientra nel buffer a cui fa riferimento il parametro Buffer , quindi viene restituito un nome troncato.

Questo metodo può anche restituire valori di errore. Per altre informazioni, vedere Valori restituiti.

Commenti

Per altre informazioni sui gruppi di simboli, vedere Ambiti e gruppi di simboli.

Requisiti

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

Vedi anche

GetNumberSymbols

IDebugSymbolGroup

IDebugSymbolGroup2

Condividi tramite