Freigeben über


IDebugHostModule2::GetVersion-Methode (dbgmodel.h)

Die GetVersion-Methode gibt Versionsinformationen zum Modul zurück (vorausgesetzt, dass diese Informationen erfolgreich aus den Headern 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 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 Nicht-NULLPTR-Adresse angegeben wird, wird hier die Produktversion des Moduls zurückgegeben, die in den Modulheadern angegeben ist. Wenn die Produktversion nicht aus den Modulheadern gelesen werden kann, tritt bei dieser Methode ein Fehler auf, wenn hier eine Nicht-NULLPTR-Adresse 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, was auf Erfolg oder Fehler hinweist.

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

IDebugHostModule2-Schnittstelle