Méthode IDebugSymbols3 ::GetModuleByModuleName2Wide (dbgeng.h)
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 |
---|---|
|
La méthode a réussi. |
|
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) |