Méthode IDebugEventCallbacks ::UnloadModule (dbgeng.h)

Article
02/23/2024

La méthode de rappel UnloadModule est appelée par le moteur lorsqu’un événement de débogage de déchargement de module se produit dans la cible.

Syntaxe

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

Paramètres

[in, optional] ImageBaseName

Spécifie le nom du fichier image du module, qui peut inclure le chemin d’accès. Si ces informations ne sont pas disponibles, ImageBaseName aura la valeur NULL.

[in] BaseOffset

Spécifie l’adresse de base du module dans l’espace d’adressage mémoire de la cible. Si ces informations ne sont pas disponibles, BaseOffset aura la valeur NULL.

Valeur retournée

Cette méthode retourne une valeur DEBUG_STATUS_XXX , qui indique comment l’exécution de la cible doit se poursuivre une fois que le moteur a traité cet événement. Pour plus d’informations sur la façon dont le moteur traite cette valeur, consultez Surveillance des événements.

Remarques

Cette méthode n’est appelée par le moteur que si l’indicateur DEBUG_EVENT_UNLOAD_MODULE est défini dans le masque retourné par IDebugEventCallbacks ::GetInterestMask.

Après avoir appelé cette méthode, le moteur appelle IDebugEventCallbacks ::ChangeSymbolState, avec le paramètre Flags contenant l’indicateur de bits DEBUG_CSS_UNLOADS.

Pour plus d’informations sur la gestion des événements, consultez Surveillance des événements.

Configuration requise

Condition requise	Valeur
Plateforme cible	Desktop (Expérience utilisateur)
En-tête	dbgeng.h (inclure Dbgeng.h)

Partager via