Funktionen GetRequestedRuntimeInfo

Artikel
05/10/2023

Hämtar version- och kataloginformation om CLR (Common Language Runtime) 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  
);

Parametrar

pExe
[in] Namnet på programmet.

pwszVersion
[in] En sträng som anger körningens versionsnummer.

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

startupFlags
[in] Ett eller flera av STARTUP_FLAGS uppräkningsvärden.

runtimeInfoFlags
[in] 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
[in] Längden på katalogbufferten.

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

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

cchBuffer
[in] 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.

Returkod	Description
S_OK	Metoden har slutförts.
ERROR_INSUFFICIENT_BUFFER	Katalogbufferten är inte tillräckligt stor för att lagra katalogsökvägen. – eller – Versionsbufferten är inte tillräckligt stor för att lagra versionssträngen.

Kommentarer

Metoden GetRequestedRuntimeInfo returnerar körningsinformation om den version som lästs 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 enligt följande:

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 för RUNTIME_INFO_FLAGS uppräkningen i taget:

RUNTIME_INFO_REQUEST_IA64
RUNTIME_INFO_REQUEST_AMD64
RUNTIME_INFO_REQUEST_X86

Krav

Plattformar: Se Systemkrav.

Huvudet: MSCorEE.h

Bibliotek: MSCorEE.dll

.NET Framework versioner: Tillgänglig sedan 1.1

Dela via