Megosztás:

GetRequestedRuntimeInfo függvény

Lekéri az alkalmazás által kért közös nyelvi futtatókörnyezet (CLR) verzió- és címtáradatait.

Ez a függvény elavult a .NET-keretrendszer 4-ben.

Szemantika

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
);

Paraméterek

pExe [in] Az alkalmazás neve.

pwszVersion [in] A futtatókörnyezet verziószámát meghatározó sztring.

pConfigurationFile [in] A konfigurációs fájl neve, amely a következőhöz pExevan társítva: .

startupFlags [in] Egy vagy több STARTUP_FLAGS enumerálási érték.

runtimeInfoFlags [in] Egy vagy több RUNTIME_INFO_FLAGS enumerálási érték.

pDirectory [kifelé] Egy puffer, amely tartalmazza a futtatókörnyezethez vezető könyvtár elérési útját a sikeres befejezés után.

dwDirectory [in] A könyvtárpuffer hossza.

dwDirectoryLength [kifelé] Mutató a könyvtár elérési útjának sztringjének hosszára.

pVersion [kifelé] Egy puffer, amely tartalmazza a futtatókörnyezet verziószámát a sikeres befejezéskor.

cchBuffer [in] A verziósztring-puffer hossza.

dwlength [kifelé] Mutató a verziósztring hosszára.

Visszaadott érték

Ez a metódus a WinError.h-ban meghatározott standard Component Object Model (COM) hibakódokat adja vissza a következő értékek mellett.

Kód visszaadása Description
S_OK A metódus sikeresen befejeződött.
ERROR_INSUFFICIENT_BUFFER A címtárpuffer nem elég nagy a címtár elérési útjának tárolásához.

-vagy-

A verziópuffer nem elég nagy a verziósztring tárolásához.

Megjegyzések

A GetRequestedRuntimeInfo metódus futásidejű adatokat ad vissza a folyamatba betöltött verzióról, amely nem feltétlenül a számítógépre telepített legújabb verzió.

A .NET-keretrendszer 2.0-s verziójában az alábbi módszerrel kaphat információt a legújabb telepített verzióról GetRequestedRuntimeInfo :

  • Adja meg a pExe, pwszVersionés pConfigurationFile a paramétereket null értékként.

  • Adja meg a RUNTIME_INFO_UPGRADE_VERSION jelölőt a RUNTIME_INFO_FLAGSruntimeInfoFlags paraméter enumerációiban.

A GetRequestedRuntimeInfo metódus a következő esetekben nem adja vissza a CLR legújabb verzióját:

  • Létezik egy alkalmazáskonfigurációs fájl, amely egy adott CLR-verzió betöltését határozza meg. Vegye figyelembe, hogy a .NET-keretrendszer akkor is használja a konfigurációs fájlt, ha null értéket ad meg a pConfigurationFile paraméterhez.

  • A CorBindToRuntimeEx metódust egy korábbi CLR-verzió megadásával nevezték el.

  • Egy korábbi CLR-verzióhoz lefordított alkalmazás jelenleg fut.

runtimeInfoFlags A paraméter esetében egyszerre csak az enumerálás egyik architektúraállandóját RUNTIME_INFO_FLAGS adhatja meg:

  • RUNTIME_INFO_REQUEST_IA64

  • RUNTIME_INFO_REQUEST_AMD64

  • RUNTIME_INFO_REQUEST_X86

Requirements

Platformok: Lásd a rendszerkövetelményeket.

Fejléc: MSCorEE.h

Kódtár: MSCorEE.dll

.NET-keretrendszerverziók: 1.1 óta érhető el

Lásd még

  • Last updated on