Compartilhar via


Função SymGetModuleBase64 (dbghelp.h)

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

Sintaxe

DWORD64 IMAGEAPI SymGetModuleBase64(
  [in] HANDLE  hProcess,
  [in] DWORD64 qwAddr
);

Parâmetros

[in] hProcess

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

[in] qwAddr

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

Retornar valor

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 para 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

Requisito Valor
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