Méthode IDebugHostModule ::GetVersion (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 dans 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 de 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, cela ne provoque pas d’échec.

productVersion

Si une adresse non nullptr est fournie, la version de 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, cela ne provoque pas d’échec.

Valeur retournée

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
}

Configuration requise

Voir aussi

Interface IDebugHostModule