GetRequestedRuntimeInfo, functie

Artikel
05/10/2023

Hiermee haalt u versie- en mapinformatie op over de Common Language Runtime (CLR) die is aangevraagd door een toepassing.

Deze functie is afgeschaft in de .NET Framework 4.

Syntaxis

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

Parameters

pExe
[in] De naam van de toepassing.

pwszVersion
[in] Een tekenreeks die het versienummer van de runtime aangeeft.

pConfigurationFile
[in] De naam van het configuratiebestand dat is gekoppeld aan pExe.

startupFlags
[in] Een of meer van de STARTUP_FLAGS opsommingswaarden.

runtimeInfoFlags
[in] Een of meer van de RUNTIME_INFO_FLAGS opsommingswaarden.

pDirectory
[uit] Een buffer die het mappad naar de runtime bevat wanneer het is voltooid.

dwDirectory
[in] De lengte van de mapbuffer.

dwDirectoryLength
[uit] Een aanwijzer naar de lengte van de tekenreeks van het mappad.

pVersion
[uit] Een buffer die het versienummer van de runtime bevat wanneer de uitvoering is voltooid.

cchBuffer
[in] De lengte van de buffer van de versietekenreeks.

dwlength
[uit] Een aanwijzer naar de lengte van de versietekenreeks.

Retourwaarde

Deze methode retourneert standaard COM-foutcodes (Component Object Model), zoals gedefinieerd in WinError.h, naast de volgende waarden.

Retourcode	Beschrijving
S_OK	De methode is voltooid.
ERROR_INSUFFICIENT_BUFFER	De mapbuffer is niet groot genoeg om het mappad op te slaan. - of - De versiebuffer is niet groot genoeg om de versietekenreeks op te slaan.

Opmerkingen

De GetRequestedRuntimeInfo methode retourneert runtime-informatie over de versie die in het proces is geladen, wat niet noodzakelijkerwijs de nieuwste versie is die op de computer is geïnstalleerd.

In .NET Framework versie 2.0 kunt u als volgt informatie krijgen over de meest recente geïnstalleerde versieGetRequestedRuntimeInfo:

Geef de pExeparameters , pwszVersionen pConfigurationFile op als null.
Geef de vlag RUNTIME_INFO_UPGRADE_VERSION op in de RUNTIME_INFO_FLAGS opsommingen voor de runtimeInfoFlags parameter.

De GetRequestedRuntimeInfo methode retourneert niet de meest recente CLR-versie in de volgende omstandigheden:

Er bestaat een toepassingsconfiguratiebestand dat aangeeft dat een bepaalde CLR-versie wordt geladen. Houd er rekening mee dat de .NET Framework het configuratiebestand gebruikt, zelfs als u null opgeeft voor de pConfigurationFile parameter.
De methode CorBindToRuntimeEx is aangeroepen om een eerdere CLR-versie op te geven.
Er wordt momenteel een toepassing uitgevoerd die is gecompileerd voor een eerdere CLR-versie.

Voor de runtimeInfoFlags parameter kunt u slechts één van de architectuurconstanten van de RUNTIME_INFO_FLAGS opsomming tegelijk opgeven:

RUNTIME_INFO_REQUEST_IA64
RUNTIME_INFO_REQUEST_AMD64
RUNTIME_INFO_REQUEST_X86

Vereisten

Platforms: Zie Systeemvereisten.

Header: MSCorEE.h

Bibliotheek: MSCorEE.dll

.NET Framework versies: beschikbaar sinds 1.1

Delen via