Método IDebugSymbolGroup2::GetSymbolValueText (dbgeng.h)

Artigo
02/26/2024

O método GetSymbolValueText retorna uma cadeia de caracteres que representa o valor de um símbolo.

Sintaxe

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

Parâmetros

[in] Index

O índice do símbolo cujo valor você deseja. O índice de um símbolo é um número de identificação. O índice varia de zero até o número de símbolos no grupo de símbolos menos um.

[out, optional] Buffer

O valor do símbolo como uma cadeia de caracteres. Se Buffer for NULL, essas informações não serão retornadas.

[in] BufferSize

O tamanho, em caracteres , do buffer buffer. Esse tamanho inclui o espaço para o caractere de terminação '\0'.

[out, optional] NameSize

O tamanho, em caracteres, do valor do símbolo. Esse tamanho inclui o espaço para o caractere de terminação '\0'. Se NameSize for NULL, essas informações não serão retornadas.

Retornar valor

Código de retorno	Descrição
S_OK	O método foi bem-sucedido.
S_FALSE	O método foi bem-sucedido. No entanto, o valor do símbolo não caberia no buffer referenciado pelo parâmetro Buffer , portanto, um valor truncado foi retornado.

Esse método também pode retornar valores de erro. Para obter mais informações, consulte Valores retornados.

Comentários

Se você adicionou o símbolo ao grupo de símbolos usando o método AddSymbol , a cadeia de caracteres retornada ao Buffer será o nome do símbolo que é passado para AddSymbol.

Para obter mais informações sobre grupos de símbolos, consulte Escopos e grupos de símbolos.