GetRequestedRuntimeInfo-funktion

Hämtar version- och kataloginformation om den common language runtime (CLR) som begärs av ett program.

Den här funktionen är inaktuell i .NET Framework 4.

Syntax

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

Parameterar

pExe [i] Namnet på programmet.

pwszVersion [i] En sträng som anger versionsnumret för körningen.

pConfigurationFile [i] Namnet på konfigurationsfilen som är associerad med pExe.

startupFlags [i] Ett eller flera av de STARTUP_FLAGS uppräkningsvärdena.

runtimeInfoFlags [i] Ett eller flera av de RUNTIME_INFO_FLAGS uppräkningsvärdena.

pDirectory [ut] En buffert som innehåller katalogsökvägen till körningen när den har slutförts.

dwDirectory [i] Längden på katalogbufferten.

dwDirectoryLength [ut] En pekare till längden på katalogsökvägssträngen.

pVersion [ut] En buffert som innehåller versionsnumret för körningen när den har slutförts.

cchBuffer [i] Längden på versionssträngbufferten.

dwlength [ut] En pekare till längden på versionssträngen.

Returvärde

Den här metoden returnerar com-felkoder (Standard Component Object Model), enligt definitionen i WinError.h, utöver följande värden.

Anmärkningar

Metoden GetRequestedRuntimeInfo returnerar körningsinformation om den version som läses in i processen, vilket inte nödvändigtvis är den senaste versionen som är installerad på datorn.

I .NET Framework version 2.0 kan du få information om den senaste installerade versionen med hjälp GetRequestedRuntimeInfo av metoden på följande sätt:

• Ange parametrarna pExe, pwszVersionoch pConfigurationFile som null.

• Ange flaggan RUNTIME_INFO_UPGRADE_VERSION i RUNTIME_INFO_FLAGS uppräkningar för parametern runtimeInfoFlags .

Metoden GetRequestedRuntimeInfo returnerar inte den senaste CLR-versionen under följande omständigheter:

• Det finns en programkonfigurationsfil som anger inläsning av en viss CLR-version. Observera att .NET Framework använder konfigurationsfilen även om du anger null för parametern pConfigurationFile .

• Metoden CorBindToRuntimeEx anropades för att ange en tidigare CLR-version.

• Ett program som kompilerats för en tidigare CLR-version körs för närvarande.

För parametern runtimeInfoFlags kan du bara ange en av arkitekturkonstanterna i RUNTIME_INFO_FLAGS uppräkningen i taget:

• RUNTIME_INFO_REQUEST_IA64

• RUNTIME_INFO_REQUEST_AMD64

• RUNTIME_INFO_REQUEST_X86

Kravspecifikation

Plattformar: Se Systemkrav.

Rubrik: MSCorEE.h

Bibliotek: MSCorEE.dll

.NET Framework-versioner: Tillgänglig sedan 1.1

Se även

• GetRequestedRuntimeVersion-funktion
• GetVersionFromProcess-funktion
• Inaktuella CLR-värdfunktioner