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

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

Sintaxe

HRESULT GetSymbolEntryStringWide(
  [in]            PDEBUG_MODULE_AND_ID Id,
  [in]            ULONG                Which,
  [out, optional] PWSTR                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 de 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