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

Article
02/23/2024

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 de l’extension. En règle générale, le chemin d’accès 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 certains cas, le nom du module diffère considérablement du nom du fichier.
DEBUG_MODNAME_LOADED_IMAGE	Nom de l’image chargée. Sauf si des 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, cette valeur est NULL. Si le débogueur mappage 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 est utilisé pour spécifier l’emplacement du module à la place.

[in] Base

Si 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, il est ignoré.

[out, optional] Buffer

Reçoit le nom du module. Si La mémoire tampon a la valeur NULL, ces informations ne sont pas retournées.

[in] BufferSize

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

[out, optional] NameSize

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

Valeur retournée

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

Code de retour	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 étant inférieure à celle du nom du module, elle a été tronquée pour tenir dans la mémoire tampon.

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

GetModuleNames

IDebugSymbols2

IDebugSymbols3

Partager via