Funzione SymGetModuleBase (dbghelp.h)

Recupera l'indirizzo di base del modulo che contiene l'indirizzo specificato.

Sintassi

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

Parametri

[in] hProcess

Handle per il processo passato originariamente alla funzione SymInitialize .

[in] dwAddr

Indirizzo virtuale contenuto in uno dei moduli caricati dalla funzione SymLoadModule64 .

Valore restituito

Se la funzione ha esito positivo, il valore restituito è un indirizzo virtuale diverso da zero. Il valore è l'indirizzo di base del modulo contenente l'indirizzo specificato dal parametro dwAddr .

Se la funzione ha esito negativo, il valore restituito è zero. Per recuperare informazioni sull'errore estese, chiamare GetLastError.

Commenti

Viene eseguita la ricerca di un modulo contenente dwAddr. Il modulo si trova in base all'indirizzo di carico e alle dimensioni di ogni modulo.

Tutte le funzioni DbgHelp, ad esempio questa, sono a thread singolo. Di conseguenza, le chiamate da più thread a questa funzione genereranno un comportamento imprevisto o un danneggiamento della memoria. Per evitare questo problema, è necessario sincronizzare tutte le chiamate simultanee da più thread a questa funzione.

Questa funzione sostituisce la funzione SymGetModuleBase . Per altre informazioni, vedere Aggiornamento del supporto della piattaforma. SymGetModuleBase è definito come segue in DbgHelp.h.

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

Requisiti

Piattaforma di destinazione	Windows
Intestazione	dbghelp.h
Libreria	Dbghelp.lib
DLL	Dbghelp.dll
Componente ridistribuibile	DbgHelp.dll 5.1 o versione successiva

Vedi anche

Funzioni DbgHelp

SymInitialize

SymLoadModule64