Sdílet prostřednictvím

GetRequestedRuntimeInfo – funkce

Získá informace o verzi a adresáři modulu CLR (Common Language Runtime) požadované aplikací.

Tato funkce je v rozhraní .NET Framework 4 zastaralá.

Syntaxe

HRESULT GetRequestedRuntimeInfo (
    [in]  LPCWSTR  pExe,
    [in]  LPCWSTR  pwszVersion,
    [in]  LPCWSTR  pConfigurationFile,
    [in]  DWORD    startupFlags,
    [in]  DWORD    runtimeInfoFlags,
    [out] LPWSTR   pDirectory,
    [in]  DWORD    dwDirectory,
    [out] DWORD   *dwDirectoryLength,
    [out] LPWSTR   pVersion,
    [in]  DWORD    cchBuffer,
    [out] DWORD   *dwlength
);

Parametry

pExe [v] Název aplikace.

pwszVersion [v] Řetězec určující číslo verze modulu runtime.

pConfigurationFile [v] Název konfiguračního souboru, který je přidružen pExe.

startupFlags [v] Jedna nebo více hodnot STARTUP_FLAGS výčtu.

runtimeInfoFlags [v] Jedna nebo více hodnot RUNTIME_INFO_FLAGS výčtu.

pDirectory [ven] Vyrovnávací paměť, která obsahuje cestu k adresáři modulu runtime po úspěšném dokončení.

dwDirectory [v] Délka vyrovnávací paměti adresáře.

dwDirectoryLength [ven] Ukazatel na délku řetězce cesty k adresáři.

pVersion [ven] Vyrovnávací paměť, která obsahuje číslo verze modulu runtime po úspěšném dokončení.

cchBuffer [v] Délka vyrovnávací paměti řetězce verze.

dwlength [ven] Ukazatel na délku řetězce verze.

Návratová hodnota

Tato metoda vrátí standardní kódy chyb modelu COM (Component Object Model), jak je definováno v winError.h, kromě následujících hodnot.

Návratový kód Description
S_OK Metoda byla úspěšně dokončena.
ERROR_INSUFFICIENT_BUFFER Vyrovnávací paměť adresáře není dostatečně velká pro uložení cesty k adresáři.

- nebo -

Vyrovnávací paměť verze není dostatečně velká k uložení řetězce verze.

Poznámky

Metoda GetRequestedRuntimeInfo vrací informace o modulu runtime o verzi načtené do procesu, což nemusí nutně být nejnovější verze nainstalovaná v počítači.

V rozhraní .NET Framework verze 2.0 můžete získat informace o nejnovější nainstalované verzi pomocí GetRequestedRuntimeInfo následující metody:

  • pExeZadejte hodnotu , pwszVersiona pConfigurationFile parametry jako null.

  • Zadejte příznak RUNTIME_INFO_UPGRADE_VERSION ve RUNTIME_INFO_FLAGS výčtech parametru runtimeInfoFlags .

Metoda GetRequestedRuntimeInfo nevrací nejnovější verzi CLR za následujících okolností:

  • Existuje konfigurační soubor aplikace, který určuje načtení konkrétní verze CLR. Všimněte si, že rozhraní .NET Framework bude používat konfigurační soubor i v případě, že pro pConfigurationFile parametr zadáte hodnotu null.

  • Byla volána metoda CorBindToRuntimeEx určující starší verzi CLR.

  • Aplikace, která byla zkompilována pro starší verzi CLR, je aktuálně spuštěná.

runtimeInfoFlags Pro parametr můžete zadat pouze jednu z konstant RUNTIME_INFO_FLAGS architektury výčtu najednou:

  • RUNTIME_INFO_REQUEST_IA64

  • RUNTIME_INFO_REQUEST_AMD64

  • RUNTIME_INFO_REQUEST_X86

Požadavky

Platformy: Viz požadavky na systém.

Záhlaví: MSCorEE.h

Knihovna: MSCorEE.dll

Verze rozhraní .NET Framework: K dispozici od verze 1.1

Viz také

  • Last updated on