Compartilhar via


Método IDebugSymbols::GetSymbolModule (dbgeng.h)

O método GetSymbolModule retorna o endereço base do módulo que contém o símbolo especificado.

Sintaxe

HRESULT GetSymbolModule(
  [in]  PCSTR    Symbol,
  [out] PULONG64 Base
);

Parâmetros

[in] Symbol

Especifica o nome do símbolo a ser pesquisado. Consulte a seção Comentários para obter detalhes sobre a sintaxe desse nome.

[out] Base

Recebe o local no espaço de endereço de memória do destino da base do módulo. Para saber mais, confira Módulos.

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.
E_NOINTERFACE
Não foi possível encontrar o símbolo ou o módulo.

Comentários

O símbolo de cadeia de caracteres deve conter um ponto de exclamação ( ! ). Se Symbol for um nome de símbolo qualificado por módulo (por exemplo, mymodules!main) ou se o nome do módulo for omitido (por exemplo, !main), o mecanismo procurará esse símbolo e retornará o módulo no qual ele foi encontrado. Se Symbol contiver apenas um nome de módulo (por exemplo, mymodule!), o mecanismo retornará o primeiro módulo com esse nome de módulo.

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)