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

Article
02/23/2024

La méthode GetModuleVersionInformation retourne des informations de version pour le module spécifié.

Syntaxe

HRESULT GetModuleVersionInformation(
  [in]            ULONG   Index,
  [in]            ULONG64 Base,
  [in]            PCSTR   Item,
  [out, optional] PVOID   Buffer,
  [in]            ULONG   BufferSize,
  [out, optional] PULONG  VerInfoSize
);

Paramètres

[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é.

[in] Item

Spécifie les informations de version demandées. Cette chaîne correspond au paramètre lpSubBlock de la fonction VerQueryValue. Pour plus d’informations sur la fonction VerQueryValue , consultez le Kit de développement logiciel (SDK) de plateforme.

[out, optional] Buffer

Reçoit les informations de version demandées. 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] VerInfoSize

Reçoit la taille en caractères des informations de version. Cette taille inclut l’espace pour le caractère de fin « \0 ». Si VerInfoSize 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 taille de la mémoire tampon était inférieure à la taille des informations de version. Dans ce cas, la mémoire tampon est remplie avec les informations de version tronquées.
E_NOINTERFACE	Le module spécifié est introuvable.

Remarques

Les informations sur la version du module sont disponibles uniquement pour les modules chargés et peuvent ne pas être disponibles dans toutes les sessions.

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