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

Article
02/06/2025

La méthode GetModuleNameString retourne le nom du module spécifié.

Syntaxe

HRESULT GetModuleNameString(
  [in]            ULONG   Which,
  [in]            ULONG   Index,
  [in]            ULONG64 Base,
  [out, optional] PSTR    Buffer,
  [in]            ULONG   BufferSize,
  [out, optional] PULONG  NameSize
);

Paramètres

[in] Which

Spécifie les noms du module à retourner, les valeurs possibles sont les suivantes :

Valeur	Description
DEBUG_MODNAME_IMAGE	Nom de l’image. Il s’agit du nom du fichier exécutable, y compris l’extension. En règle générale, le chemin complet est inclus en mode utilisateur, mais pas en mode noyau.
DEBUG_MODNAME_MODULE	Nom du module. Il s’agit généralement simplement du nom de fichier sans l’extension. Dans quelques cas, le nom du module diffère considérablement du nom de fichier.
DEBUG_MODNAME_LOADED_IMAGE	Nom de l’image chargée. Sauf si les symboles Microsoft CodeView sont présents, il s’agit du même nom que celui de l’image.
DEBUG_MODNAME_SYMBOL_FILE	Nom du fichier de symboles. Chemin d’accès et nom du fichier de symboles. Si aucun symbole n’a été chargé, il s’agit du nom du fichier exécutable à la place.
DEBUG_MODNAME_MAPPED_IMAGE	Nom de l’image mappée. Dans la plupart des cas, il s’agit NULL . Si le débogueur mappé un fichier image (par exemple, pendant le débogage minidump), il s’agit du nom de l’image mappée.

[in] Index

Spécifie l’index du module. S’il est défini sur DEBUG_ANY_ID, le paramètre base de est utilisé pour spécifier l’emplacement du module à la place.

[in] Base

Si d’index est DEBUG_ANY_ID, spécifie l’emplacement dans l’espace d’adressage mémoire de la cible de la base du module. Sinon, elle est ignorée.

[out, optional] Buffer

Reçoit le nom du module. Si tampon est NULL, ces informations ne sont pas retournées.

[in] BufferSize

Spécifie la taille en caractères de la mémoire tampon tampon. Cette taille inclut l’espace du caractère de fin « \0 ».

[out, optional] NameSize

Reçoit la taille en caractères du nom du module. Cette taille inclut l’espace du caractère de fin « \0 ». Si NameSize est NULL, ces informations ne sont pas retournées.

Valeur de retour

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

Retourner le code	Description
S_OK	La méthode a réussi.
S_FALSE	La méthode a réussi. Toutefois, la taille de la mémoire tampon était inférieure à la taille du nom du module afin qu’elle soit tronquée pour s’adapter à la mémoire tampon.

Remarques

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

Exigences

Exigence	Valeur
plateforme cible	Bureau
d’en-tête	dbgeng.h (include Dbgeng.h)

Voir aussi

GetModuleNames

IDebugSymbols2

IDebugSymbols3

Partager via