Compartilhar via

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

  • Artigo

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

Sintaxe

HRESULT GetSymbolName(
  [in]            ULONG  Index,
  [out, optional] PSTR   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 o 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.

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 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.

Comentários

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

Requisitos

Requisito Valor
Plataforma de Destino Área de Trabalho
Cabeçalho dbgeng.h (inclua Dbgeng.h)

Confira também

GetNumberSymbols

IDebugSymbolGroup

IDebugSymbolGroup2