Metodo IDebugSymbolGroup2::GetSymbolValueText (dbgeng.h)
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 |
---|---|
|
Il metodo è stato eseguito correttamente. |
|
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) |