Méthode IDebugSymbols3 ::AddSyntheticModule (dbgeng.h)

Article
02/23/2024

La méthode AddSyntheticModule ajoute un module synthétique à la liste de modules que le débogueur gère pour le processus actuel.

Syntaxe

HRESULT AddSyntheticModule(
  [in] ULONG64 Base,
  [in] ULONG   Size,
  [in] PCSTR   ImagePath,
  [in] PCSTR   ModuleName,
  [in] ULONG   Flags
);

Paramètres

[in] Base

Spécifie l’emplacement dans l’espace d’adressage virtuel du processus de la base du module synthétique.

[in] Size

Spécifie la taille en octets du module synthétique.

[in] ImagePath

Spécifie le nom de l’image du module synthétique. Il s’agit du nom qui sera retourné comme nom du fichier exécutable pour le module synthétique. Le chemin d’accès complet doit être inclus s’il est connu.

[in] ModuleName

Spécifie le nom du module synthétique.

[in] Flags

Définissez sur DEBUG_ADDSYNTHMOD_DEFAULT.

Valeur retournée

Code de retour	Description
S_OK	La méthode a réussi.

Cette méthode peut également retourner des valeurs d’erreur. Pour plus d’informations, consultez Valeurs de retour.

Remarques

La région de mémoire du module synthétique, décrite par les paramètres Base et Size , ne doit pas chevaucher la région mémoire d’un autre module.

Si tous les modules sont rechargés (par exemple, en appelant Reload avec le paramètre Module défini sur une chaîne vide), tous les modules synthétiques sont ignorés.

Pour plus d’informations sur les modules synthétiques, consultez Modules synthétiques.