IDebugEventCallbacks::UnloadModule-Methode (dbgeng.h)

Artikel
02/06/2025

Die UnloadModule- Rückrufmethode wird vom Modul aufgerufen, wenn ein Modul-Unload-Debugging-Ereignis im Ziel auftritt.

Syntax

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

Parameter

[in, optional] ImageBaseName

Gibt den Namen der Bilddatei des Moduls an, die den Pfad enthalten kann. Wenn diese Informationen nicht verfügbar sind, wird ImageBaseName-NULL-.

[in] BaseOffset

Gibt die Basisadresse des Moduls im Speicheradressbereich des Ziels an. Wenn diese Informationen nicht verfügbar sind, wird BaseOffset-NULL-.

Rückgabewert

Diese Methode gibt einen DEBUG_STATUS_XXX Wert zurück, der angibt, wie die Ausführung des Ziels fortgesetzt werden soll, nachdem das Modul dieses Ereignis verarbeitet hat. Ausführliche Informationen zur Behandlung dieses Werts finden Sie unter Monitoring Events.

Bemerkungen

Diese Methode wird nur vom Modul aufgerufen, wenn das DEBUG_EVENT_UNLOAD_MODULE Flag in der Maske festgelegt wird, die von IDebugEventCallbacks::GetInterestMaskzurückgegeben wird.

Nach dem Aufrufen dieser Methode ruft das Modul IDebugEventCallbacks::ChangeSymbolStateauf, wobei der parameter Flags enthält, der die Bitkennzeichnung DEBUG_CSS_UNLOADS enthält.

Weitere Informationen zum Behandeln von Ereignissen finden Sie unter Monitoring Events.

Anforderungen

Anforderung	Wert
Zielplattform-	Desktop
Header-	dbgeng.h (include Dbgeng.h)

Freigeben über