Metodo IDebugEventCallbacks::UnloadModule (dbgeng.h)

Articolo
02/25/2024

Il metodo di callback UnloadModule viene chiamato dal motore quando si verifica un evento di debug di tipo 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 sarà NULL.

[in] BaseOffset

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

Valore restituito

Questo metodo restituisce un valore DEBUG_STATUS_XXX , che indica come l'esecuzione della destinazione deve procedere dopo che il motore elabora questo evento. Per informazioni dettagliate sul modo in cui il motore tratta questo valore, vedere Monitoraggio degli eventi.

Commenti

Questo metodo viene chiamato solo dal motore 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 degli eventi.

Requisiti

Requisito	Valore
Piattaforma di destinazione	Desktop
Intestazione	dbgeng.h (includere Dbgeng.h)

Condividi tramite