Metodo IDebugSymbolGroup2::GetSymbolValueTextWide (dbgeng.h)

Articolo
08/07/2023

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

Sintassi

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

Parametri

[in] Index

Indice del simbolo di cui si desidera. 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

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

[in] BufferSize

Dimensione, in caratteri, del buffer buffer del 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 rientra nel 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 il simbolo è stato aggiunto al gruppo di simboli utilizzando 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.