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

Artigo
02/06/2025

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

Sintaxe

HRESULT GetSymbolValueTextWide(
  [in]            ULONG  Index,
  [out, optional] PWSTR  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 de 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.

Valor de retorno

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.

Observações

Se você adicionou o símbolo ao grupo de símbolos usando o método AddSymbol, a cadeia de caracteres retornada para buffer é 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.

Requisitos

Requisito	Valor
da Plataforma de Destino	Área de trabalho
cabeçalho	dbgeng.h (inclua Dbgeng.h)

Consulte também

GetNumberSymbols

IDebugSymbolGroup2

WriteSymbol

Partilhar via