Metodo IDebugSymbolGroup2::GetSymbolValueText (dbgeng.h)

Articolo
02/23/2024

Il metodo GetSymbolValueText restituisce una stringa che rappresenta il valore di un simbolo.

Sintassi

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

Parametri

[in] Index

Indice del simbolo il cui valore desiderato. L'indice di un simbolo è un numero di identificazione. L'indice varia da zero al numero di simboli nel gruppo di simboli meno uno.

[out, optional] Buffer

Valore del simbolo come stringa. Se buffer è NULL, queste informazioni non vengono restituite.

[in] BufferSize

Dimensioni, in caratteri, del buffer buffer . Questa dimensione include lo spazio per il carattere di terminazione '\0'.

[out, optional] NameSize

Dimensione, in caratteri, del valore 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 valore del simbolo non si adatta al buffer a cui fa riferimento il parametro Buffer , quindi viene restituito un valore troncato.

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

Commenti

Se è stato aggiunto il simbolo al gruppo di simboli usando il metodo AddSymbol , la stringa restituita a Buffer è il nome del simbolo passato a AddSymbol.

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

Requisiti

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

Vedi anche

GetNumberSymbols

IDebugSymbolGroup2

WriteSymbol

Condividi tramite