IDebugHostModule::GetVersion-Methode (dbgmodel.h)

Die GetVersion-Methode gibt Versionsinformationen über das Modul zurück (vorausgesetzt, dass solche Informationen erfolgreich aus den Kopfzeilen gelesen werden können). Wenn eine bestimmte Version angefordert wird (über einen Nicht-Nullptr-Ausgabezeiger) und nicht gelesen werden kann, wird ein entsprechender Fehlercode vom Methodenaufruf zurückgegeben.

Syntax

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

Parameter

fileVersion

Wenn eine nicht nullptr-Adresse angegeben wird, wird die Dateiversion des Moduls hier zurückgegeben. Wenn die Dateiversion nicht aus den Modulheadern gelesen werden kann, schlägt diese Methode fehl, wenn hier eine nicht nullptr-Adresse bereitgestellt wird. Wenn die Dateiversion nicht aus den Modulheadern gelesen werden kann und dieser Wert als Nullptr bereitgestellt wird, verursacht es keinen Fehler.

productVersion

Wenn eine Nicht-Nullptr-Adresse angegeben ist, wird die Produktversion des Moduls wie in den Modulüberschriften hier zurückgegeben. Wenn die Produktversion nicht aus den Modulkopfzeilen gelesen werden kann, schlägt diese Methode fehl, wenn hier eine nicht nullptr-Adresse bereitgestellt wird. Wenn die Produktversion nicht aus den Modulkopfzeilen gelesen werden kann und dieser Wert als Nullptr bereitgestellt wird, verursacht es keinen Fehler.

Rückgabewert

Diese Methode gibt HRESULT zurück, die Erfolg oder Fehler angibt.

Bemerkungen

Beispielcode

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
}

Anforderungen

   
Header dbgmodel.h

Siehe auch

IDebugHostModule-Schnittstelle