IDebugHostModule::GetVersion-Methode (dbgmodel.h)

  • Artikel

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

Syntax

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

Parameter

fileVersion

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

productVersion

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

Rückgabewert

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

Hinweise

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

Anforderung Wert
Header dbgmodel.h

Weitere Informationen

IDebugHostModule-Schnittstelle