Compartilhar via


Função SymGetModuleBase (dbghelp.h)

Recupera o endereço base do módulo que contém o endereço especificado.

Sintaxe

DWORD IMAGEAPI SymGetModuleBase(
  [in] HANDLE hProcess,
  [in] DWORD  dwAddr
);

Parâmetros

[in] hProcess

Um identificador para o processo que foi originalmente passado para a função SymInitialize .

[in] dwAddr

O endereço virtual contido em um dos módulos carregados pela função SymLoadModule64 .

Valor retornado

Se a função for bem-sucedida, o valor retornado será um endereço virtual diferente de zero. O valor é o endereço base do módulo que contém o endereço especificado pelo parâmetro dwAddr .

Se a função falhar, o valor retornado será zero. Para recuperar informações de erro estendidas, chame GetLastError.

Comentários

A tabela de módulos é pesquisada por um módulo que contém dwAddr. O módulo está localizado com base no endereço de carga e no tamanho de cada módulo.

Todas as funções DbgHelp, como esta, são threaded único. Portanto, chamadas de mais de um thread para essa função provavelmente resultarão em comportamento inesperado ou corrupção de memória. Para evitar isso, você deve sincronizar todas as chamadas simultâneas de mais de um thread para essa função.

Essa função substitui a função SymGetModuleBase . Para obter mais informações, consulte Suporte de plataforma atualizado. SymGetModuleBase é definido da seguinte maneira em DbgHelp.h.

#if !defined(_IMAGEHLP_SOURCE_) && defined(_IMAGEHLP64)
#define SymGetModuleBase SymGetModuleBase64
#else
DWORD
IMAGEAPI
SymGetModuleBase(
    __in HANDLE hProcess,
    __in DWORD dwAddr
    );
#endif

Requisitos

   
Plataforma de Destino Windows
Cabeçalho dbghelp.h
Biblioteca Dbghelp.lib
DLL Dbghelp.dll
Redistribuível DbgHelp.dll 5.1 ou posterior

Confira também

Funções DbgHelp

SymInitialize

SymLoadModule64