Compartilhar via

Método IDebugSymbols3::GetSymbolEntryString (dbgeng.h)

  • Artigo

O método GetSymbolEntryString retorna informações de cadeia de caracteres para o símbolo especificado.

Sintaxe

HRESULT GetSymbolEntryString(
  [in]            PDEBUG_MODULE_AND_ID Id,
  [in]            ULONG                Which,
  [out, optional] PSTR                 Buffer,
  [in]            ULONG                BufferSize,
  [out, optional] PULONG               StringSize
);

Parâmetros

[in] Id

Especifica os símbolos cujas regiões de memória estão sendo solicitadas. A estrutura DEBUG_MODULE_AND_ID contém o módulo que contém o símbolo e a ID do símbolo dentro do módulo.

[in] Which

Especifica o índice da cadeia de caracteres desejada. Geralmente, isso é zero, pois a maioria dos símbolos contém apenas uma cadeia de caracteres (seu nome). Mas alguns símbolos podem conter mais de uma cadeia de caracteres , por exemplo, símbolos de anotação.

[out, optional] Buffer

Recebe o nome do símbolo. Se Buffer for NULL, essas informações não serão retornadas.

[in] BufferSize

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

[out, optional] StringSize

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

Retornar valor

Esse método também pode retornar valores de erro. Consulte Valores retornados para obter mais detalhes.

Código de retorno Descrição
S_OK
 O método foi bem-sucedido.

Comentários

Para obter mais informações sobre símbolos, consulte Símbolos.

Requisitos

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

Confira também

GetSymbolEntriesByName

GetSymbolEntriesByOffset

IDebugSymbols3