Méthode IDebugSymbols ::GetModuleNames (dbgeng.h)

Article
08/07/2023

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. 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
S_OK	La méthode a réussi.
S_FALSE	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.
E_NOINTERFACE	Le module spécifié est introuvable.