Metodo IDebugEventCallbacks::UnloadModule (dbgeng.h)

Articolo
02/06/2025

Il UnloadModule metodo di callback viene chiamato dal motore quando si verifica un evento di debug module-unload nella destinazione.

Sintassi

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

Parametri

[in, optional] ImageBaseName

Specifica il nome del file di immagine del modulo, che può includere il percorso. Se queste informazioni non sono disponibili, ImageBaseName verrà NULL.

[in] BaseOffset

Specifica l'indirizzo di base del modulo nello spazio indirizzi di memoria della destinazione. Se queste informazioni non sono disponibili, BaseOffset verrà NULL.

Valore restituito

Questo metodo restituisce un valore DEBUG_STATUS_XXX, che indica il modo in cui l'esecuzione della destinazione deve procedere dopo l'elaborazione dell'evento da parte del motore. Per informazioni dettagliate sul modo in cui il motore gestisce questo valore, vedere Monitoraggio eventi.

Osservazioni

Questo metodo viene chiamato dal motore solo se il flag DEBUG_EVENT_UNLOAD_MODULE è impostato nella maschera restituita da IDebugEventCallbacks::GetInterestMask.

Dopo aver chiamato questo metodo, il motore chiamerà IDebugEventCallbacks::ChangeSymbolState, con il parametro Flags contenente il flag di bit DEBUG_CSS_UNLOADS.

Per altre informazioni sulla gestione degli eventi, vedere Monitoraggio eventi.

Fabbisogno

Requisito	Valore
piattaforma di destinazione	Desktop
intestazione	dbgeng.h (include Dbgeng.h)

Condividi tramite