Partager via


IDebugHostModule ::GetVersion, méthode (dbgmodel.h)

La méthode GetVersion retourne des informations de version sur le module (en supposant que ces informations peuvent être lues avec succès sur les en-têtes). Si une version donnée est demandée (via un pointeur de sortie non nullptr) et qu’elle ne peut pas être lue, un code d’erreur approprié est retourné à partir de l’appel de méthode.

Syntaxe

HRESULT GetVersion(
  ULONG64 *fileVersion,
  ULONG64 *productVersion
);

Paramètres

fileVersion

Si une adresse non nullptr est fournie, la version du fichier du module est retournée ici. Si la version du fichier ne peut pas être lue à partir des en-têtes de module, cette méthode échoue si une adresse non nullptr est fournie ici. Si la version du fichier ne peut pas être lue à partir des en-têtes de module et que cette valeur est fournie en tant que nullptr, elle n’entraîne pas de défaillance.

productVersion

Si une adresse non nullptr est fournie, la version du produit du module comme indiqué dans les en-têtes de module est retournée ici. Si la version du produit ne peut pas être lue à partir des en-têtes de module, cette méthode échoue si une adresse non nullptr est fournie ici. Si la version du produit ne peut pas être lue à partir des en-têtes de module et que cette valeur est fournie en tant que nullptr, elle n’entraîne pas de défaillance.

Valeur de retour

Cette méthode retourne HRESULT qui indique la réussite ou l’échec.

Remarques

exemple de code

ComPtr<IDebugHostModule> spModule; /* get a module (see FindModuleByName) */

ULONG64 fileVersion;
ULONG64 productVersion;
if (SUCCEEDED(spModule->GetVersion(&fileVersion, &productVersion)))
{
    // fileVersion contains a.b.c.d (16.16.16.16) file version
    // productVersion contains a.b.c.d (16.16.16.16) product version
}

Exigences

Exigence Valeur
d’en-tête dbgmodel.h

Voir aussi

interface IDebugHostModule