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

Artigo
02/06/2025

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.

Valor de retorno

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

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

Observações

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

Requisitos

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

Consulte também

GetSymbolEntriesByName

GetSymbolEntriesByOffset

IDebugSymbols3

Compartilhar via