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

  • Article

La méthode GetModuleByModuleName2Wide recherche dans les modules du processus un avec le nom spécifié.

Syntaxe

HRESULT GetModuleByModuleName2Wide(
  [in]            PCWSTR   Name,
  [in]            ULONG    StartIndex,
  [in]            ULONG    Flags,
  [out, optional] PULONG   Index,
  [out, optional] PULONG64 Base
);

Paramètres

[in] Name

Spécifie le nom du module souhaité.

[in] StartIndex

Spécifie l’index à partir duquel commencer la recherche.

[in] Flags

Spécifie un jeu de bits contenant les options utilisées lors de la recherche du module portant le nom spécifié. Les indicateurs peuvent contenir les indicateurs de bits suivants :

Indicateur Effet
DEBUG_GETMOD_NO_LOADED_MODULES Ne recherchez pas les modules chargés.
DEBUG_GETMOD_NO_UNLOADED_MODULES Ne recherchez pas les modules déchargés.

[out, optional] Index

Reçoit l’index du premier module portant le nom Name. Si Index a la valeur NULL, ces informations ne sont pas retournées.

[out, optional] Base

Reçoit l’emplacement dans l’espace d’adressage mémoire de la cible de la base du module. Si Base a la valeur NULL, ces informations ne sont pas retournées.

Valeur retournée

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

Code de retour Description
S_OK
 La méthode a réussi.
E_INVALIDARG
 L’un des arguments passés n’était pas valide.

Remarques

À partir de l’index spécifié, ces méthodes retournent le premier module qu’elles trouvent avec le nom spécifié. Si la cible a plusieurs modules portant ce nom, les modules suivants peuvent être trouvés par des appels répétés à ces méthodes avec des valeurs supérieures de StartIndex.

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

Configuration requise

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

Voir aussi

GetModuleByModuleName

IDebugSymbols3