IDebugEventCallbacks::UnloadModule-Methode (dbgeng.h)

Artikel
02/23/2024

Die UnloadModule-Rückrufmethode wird von der Engine aufgerufen, wenn im Ziel ein Debugereignis zum Entladen des Moduls auftritt.

Syntax

HRESULT UnloadModule(
  [in, optional] PCSTR   ImageBaseName,
  [in]           ULONG64 BaseOffset
);

Parameter

[in, optional] ImageBaseName

Gibt den Namen der Imagedatei des Moduls an, die den Pfad enthalten kann. Wenn diese Informationen nicht verfügbar sind, ist ImageBaseNameNULL.

[in] BaseOffset

Gibt die Basisadresse des Moduls im Speicheradressraum des Ziels an. Wenn diese Informationen nicht verfügbar sind, ist BaseOffsetNULL.

Rückgabewert

Diese Methode gibt einen DEBUG_STATUS_XXX Wert zurück, der angibt, wie die Ausführung des Ziels nach der Verarbeitung dieses Ereignisses durch das Modul fortgesetzt werden soll. Ausführliche Informationen zur Behandlung dieses Werts durch das Modul finden Sie unter Überwachungsereignisse.

Hinweise

Diese Methode wird nur von der Engine aufgerufen, wenn das DEBUG_EVENT_UNLOAD_MODULE-Flag in der von IDebugEventCallbacks::GetInterestMask zurückgegebenen Maske festgelegt ist.

Nach dem Aufrufen dieser Methode ruft das Modul IDebugEventCallbacks::ChangeSymbolState auf, wobei der Flags-Parameter das Bitflag DEBUG_CSS_UNLOADS enthält.

Weitere Informationen zur Behandlung von Ereignissen finden Sie unter Überwachen von Ereignissen.

Anforderungen

Anforderung	Wert
Zielplattform	Desktop
Kopfzeile	dbgeng.h (einschließlich Dbgeng.h)

Freigeben über