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

Article
02/06/2025

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 est 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 du 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 du caractère de fin « \0 ». Si ImageNameSize est NULL, ces informations ne sont pas retournées.

[out, optional] ModuleNameBuffer

Reçoit le nom du module. Si ModuleNameBuffer est 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 du caractère de fin « \0 ».

[out, optional] ModuleNameSize

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

[out, optional] LoadedImageNameBuffer

Reçoit le nom de l’image chargée du module. Si LoadedImageNameBuffer est 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 du 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 du caractère de fin « \0 ». Si LoadedImageNameSize est NULL, ces informations ne sont pas retournées.

Valeur de retour

Cette méthode peut également retourner d’autres 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, au moins l’un des ImageNameBuffer, ModuleNameBufferou LoadedImageNameBuffer était trop petit pour le nom correspondant, il a donc été tronqué.
E_NOINTERFACE	Le module spécifié est introuvable.