GetRequestedRuntimeInfo – funkce

Článek
05/10/2023

Získá informace o verzi a adresáři common language runtime (CLR) 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 přidruženého k pExe.

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

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

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

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

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

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

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

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

Návratová hodnota

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

Návratový kód	Description
S_OK	Metoda se úspěšně dokončila.
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á pro uložení řetězce verze.

Poznámky

Metoda GetRequestedRuntimeInfo vrátí informace o verzi načtené do procesu za běhu, což nemusí být nutně 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 metody takto:

pExeZadejte parametry , pwszVersiona pConfigurationFile jako hodnotu null.
Ve výčtu RUNTIME_INFO_FLAGSruntimeInfoFlags parametru zadejte příznak RUNTIME_INFO_UPGRADE_VERSION.

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 použije konfigurační soubor i v případě, že jako pConfigurationFile parametr zadáte hodnotu null.
Metoda CorBindToRuntimeEx byla volána určení starší verze CLR.
Aplikace, která byla zkompilována pro starší verzi CLR, je aktuálně spuštěná.

runtimeInfoFlags Pro parametr můžete současně zadat pouze jednu z konstant architektury výčtuRUNTIME_INFO_FLAGS:

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

Sdílet prostřednictvím