Méthode IDebugSymbols3 ::GetModuleNames (dbgeng.h)
La méthode GetModuleNames retourne les noms du module spécifié.
Syntaxe
HRESULT GetModuleNames(
[in] ULONG Index,
[in] ULONG64 Base,
[out, optional] PSTR ImageNameBuffer,
[in] ULONG ImageNameBufferSize,
[out, optional] PULONG ImageNameSize,
[out, optional] PSTR ModuleNameBuffer,
[in] ULONG ModuleNameBufferSize,
[out, optional] PULONG ModuleNameSize,
[out, optional] PSTR LoadedImageNameBuffer,
[in] ULONG LoadedImageNameBufferSize,
[out, optional] PULONG LoadedImageNameSize
);
Paramètres
[in] Index
Spécifie l’index du module dont les noms sont demandés. S’il est défini sur DEBUG_ANY_ID, le module est spécifié par Base.
[in] Base
Spécifie l’adresse de base du module dont les noms sont demandés. Ce paramètre est utilisé uniquement si Index est défini sur DEBUG_ANY_ID.
[out, optional] ImageNameBuffer
Reçoit le nom de l’image du module. Si ImageNameBuffer a la valeur NULL, ces informations ne sont pas retournées.
[in] ImageNameBufferSize
Spécifie la taille en caractères de la mémoire tampon ImageNameBuffer en caractères. Cette taille inclut l’espace pour le caractère de fin « \0 ».
[out, optional] ImageNameSize
Reçoit la taille en caractères du nom de l’image. Cette taille inclut l’espace pour le caractère de fin « \0 ». Si ImageNameSize a la valeur NULL, ces informations ne sont pas retournées.
[out, optional] ModuleNameBuffer
Reçoit le nom du module. Cette taille inclut l’espace pour le caractère de fin « \0 ». Si ModuleNameBuffer a la valeur NULL, ces informations ne sont pas retournées.
[in] ModuleNameBufferSize
Spécifie la taille en caractères de la mémoire tampon ModuleNameBuffer. Cette taille inclut l’espace pour le caractère de fin « \0 ».
[out, optional] ModuleNameSize
Reçoit la taille en caractères du nom du module. Cette taille inclut l’espace pour le caractère de fin « \0 ». Si ModuleNameSize a la valeur NULL, ces informations ne sont pas retournées.
[out, optional] LoadedImageNameBuffer
Reçoit le nom de l’image chargée du module. Si LoadedImageNameBuffer a la valeur NULL, ces informations ne sont pas retournées.
[in] LoadedImageNameBufferSize
Spécifie la taille en caractères de la mémoire tampon LoadedImageNameBuffer. Cette taille inclut l’espace pour le caractère de fin « \0 ».
[out, optional] LoadedImageNameSize
Reçoit la taille en caractères du nom de l’image chargée. Cette taille inclut l’espace pour le caractère de fin « \0 ». Si LoadedImageNameSize 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. |
|
La méthode a réussi. Toutefois, au moins l’une des images ImageNameBuffer, ModuleNameBuffer ou LoadedImageNameBuffer était trop petite pour le nom correspondant. Elle a donc été tronquée. |
|
Le module spécifié est introuvable. |
Remarques
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
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour