Metodo IDebugSymbolGroup2::GetSymbolValueTextWide (dbgeng.h)

Articolo
02/06/2025

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 il valore. 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 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 ha avuto esito positivo.
S_FALSE	Il metodo ha avuto esito positivo. 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.

Osservazioni

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.