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

Artigo
02/06/2025

O método GetSymbolNameWide retorna o nome de um símbolo em um grupo de símbolos.

Sintaxe

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

Parâmetros

[in] Index

O índice do símbolo cujo nome 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 nome do símbolo. Se buffer for NULL, essas informações não serão retornadas.

[in] BufferSize

O tamanho do buffer para o qual Buffer aponta. Esse tamanho inclui o espaço para o caractere de terminação '\0'.

[out, optional] NameSize

O tamanho do nome 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 nome do símbolo não se encaixava no buffer referenciado pelo parâmetro Buffer, portanto, um nome truncado foi retornado.

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

Observações

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

Compartilhar via