Compartilhar via

Método IDebugAdvanced3::GetSymbolInformationWide (dbgeng.h)

  • Artigo

O método SetSymbolInformationWide retorna informações especificadas sobre um símbolo.

Sintaxe

HRESULT GetSymbolInformationWide(
  [in]            ULONG   Which,
  [in]            ULONG64 Arg64,
  [in]            ULONG   Arg32,
  [out, optional] PVOID   Buffer,
  [in]            ULONG   BufferSize,
  [out, optional] PULONG  InfoSize,
  [out, optional] PWSTR   StringBuffer,
  [in]            ULONG   StringBufferSize,
  [out, optional] PULONG  StringSize
);

Parâmetros

[in] Which

Especifica a informação a ser retornada. O que pode levar um dos valores na tabela a seguir.

Valor Informações retornadas
DEBUG_SYMINFO_BREAKPOINT_SOURCE_LINE Retorna o nome do arquivo de código-fonte e o número de linha para um ponto de interrupção especificado. O número de linha é retornado para Buffer como um ULONG. O nome do arquivo é retornado para StringBuffer.
DEBUG_SYMINFO_IMAGEHLP_MODULEW64 Retorna uma estrutura IMAGEHLP_MODULEW64 que descreve um módulo especificado. Para obter detalhes sobre essa estrutura, consulte o tópico IMAGEHLP_MODULE64 na documentação da Biblioteca de Ajuda de Depuração (dbghelp.chm).

Nenhuma cadeia de caracteres é retornada e StringBuffer, StringBufferSize e StringSize devem ser definidos como zero.
DEBUG_SYMINFO_GET_SYMBOL_NAME_BY_OFFSET_AND_TAG_WIDE Retorna o nome Unicode do símbolo especificado pelo local na memória e tipo de marca PDB. O nome é retornado para Buffer. StringBuffer não é usado.
DEBUG_SYMINFO_GET_MODULE_SYMBOL_NAMES_AND_OFFSETS Retorna uma lista de nomes de símbolos e deslocamentos para os símbolos no módulo especificado com o tipo de marca PDB especificado. Os deslocamentos são retornados como uma matriz de valores ULONG para Buffer. Os nomes são retornados na mesma ordem que os deslocamentos para StringBuffer. Alguns nomes podem conter zeros inseridos porque as anotações podem ter nomes de várias partes; portanto, cada nome é encerrado com dois caracteres nulos.

[in] Arg64

Especifica um argumento de 64 bits. Esse parâmetro tem as seguintes interpretações dependendo do valor de Qual:

DEBUG_SYMINFO_BREAKPOINT_SOURCE_LINE

Ignorado.

DEBUG_SYMINFO_IMAGEHLP_MODULEW64

O endereço base do módulo cuja descrição está sendo solicitada.

DEBUG_SYMINFO_GET_SYMBOL_NAME_BY_OFFSET_AND_TAG_WIDE

Especifica o endereço na memória do destino do símbolo cujo nome está sendo solicitado.

DEBUG_SYMINFO_GET_MODULE_SYMBOL_NAMES_AND_OFFSETS

Especifica o módulo cujos símbolos são solicitados. Arg64 é um local dentro da alocação de memória do módulo.

[in] Arg32

Especifica um argumento de 32 bits. Esse parâmetro tem as seguintes interpretações dependendo do valor de Qual:

DEBUG_SYMINFO_BREAKPOINT_SOURCE_LINE

A ID do ponto de interrupção do mecanismo do ponto de interrupção desejado.

DEBUG_SYMINFO_IMAGEHLP_MODULEW64

Defina como zero.

DEBUG_SYMINFO_GET_SYMBOL_NAME_BY_OFFSET_AND_TAG_WIDE

A classificação PDB do símbolo. Arg32 deve ser um dos valores na enumeração SymTagEnum definida em Dbghelp.h. Para obter mais informações, consulte a documentação do PDB.

DEBUG_SYMINFO_GET_MODULE_SYMBOL_NAMES_AND_OFFSETS

A classificação PDB do símbolo. Arg32 deve ser um dos valores na enumeração SymTagEnum definida em Dbghelp.h. Para obter mais informações, consulte a documentação do PDB.

[out, optional] Buffer

Recebe as informações de símbolo solicitadas. O tipo dos dados retornados depende do valor de Qual. Se Buffer for NULL, essas informações não serão retornadas.

[in] BufferSize

Especifica o tamanho, em bytes, do buffer Buffer.

[out, optional] InfoSize

Se esse método retornar S_OK, InfoSize receberá o tamanho, em bytes, das informações de símbolo retornadas ao Buffer. Se esse método retornar S_FALSE, o buffer fornecido não será grande o suficiente e o InfoSize receberá o tamanho do buffer necessário. Se InfoSize for NULL, essas informações não serão retornadas.

[out, optional] StringBuffer

Recebe a cadeia de caracteres solicitada. A interpretação dessa cadeia de caracteres depende do valor de Qual. Se StringBuffer for NULL, essas informações não serão retornadas.

[in] StringBufferSize

Especifica o tamanho, em caracteres, do buffer de cadeia de caracteres StringBuffer.

[out, optional] StringSize

Recebe o tamanho, em caracteres, da cadeia de caracteres retornada para StringBuffer. 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.
S_FALSE
 O método foi bem-sucedido. No entanto, as informações não caberiam no Buffer de buffer ou a cadeia de caracteres não caberia no stringBuffer do buffer, portanto, as informações ou o nome foram truncados.

Requisitos

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