GetRequestedRuntimeInfo-Funktion

Artikel
06/12/2023

Ruft Versions- und Verzeichnisinformationen zur Common Language Runtime (CLR) ab, die von einer Anwendung angefordert wurden.

Diese Funktion ist in .NET Framework 4 veraltet.

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

Parameter

pExe
[in] Der Name der Anwendung.

pwszVersion
[in] Eine Zeichenfolge, die die Versionsnummer der Runtime angibt.

pConfigurationFile
[in] Der Name der Konfigurationsdatei, die pExe zugeordnet ist.

startupFlags
[in] Mindestens einer der STARTUP_FLAGS-Enumerationswerte.

runtimeInfoFlags
[in] Mindestens einer der RUNTIME_INFO_FLAGS-Enumerationswerte.

pDirectory
[out] Ein Puffer, der nach erfolgreichem Abschluss den Verzeichnispfad zur Runtime enthält.

dwDirectory
[in] Die Länge des Verzeichnispuffers.

dwDirectoryLength
[out] Ein Zeiger auf die Länge der Verzeichnispfadzeichenfolge.

pVersion
[out] Ein Puffer, der nach erfolgreichem Abschluss die Versionsnummer der Runtime enthält.

cchBuffer
[in] Die Länge des Puffers für die Versionszeichenfolge.

dwlength
[out] Ein Zeiger auf die Länge der Versionszeichenfolge.

Rückgabewert

Diese Methode gibt zusätzlich zu den folgenden Werten COM-Standardfehlercodes (Component Object Model) zurück, die in „WinError.h“ definiert sind.

Rückgabecode	Beschreibung
S_OK	Die Methode wurde erfolgreich abgeschlossen.
ERROR_INSUFFICIENT_BUFFER	Der Verzeichnispuffer ist nicht groß genug, um den Verzeichnispfad zu speichern. - oder - Der Versionspuffer ist nicht groß genug, um die Versionszeichenfolge zu speichern.

Bemerkungen

Die GetRequestedRuntimeInfo-Methode gibt Laufzeitinformationen zur in den Prozess geladenen Version zurück. Hierbei handelt es sich nicht zwingend um die neueste auf dem Computer installierte Version.

In .NET Framework 2.0 können Sie Informationen zur neuesten installierten Version abrufen, indem Sie die GetRequestedRuntimeInfo-Methode wie folgt verwenden:

Geben Sie für die Parameter pExe, pwszVersion und pConfigurationFile jeweils NULL an.
Geben Sie in den RUNTIME_INFO_FLAGS-Enumerationen für den runtimeInfoFlags-Parameter das RUNTIME_INFO_UPGRADE_VERSION-Flag an.

Die GetRequestedRuntimeInfo-Methode gibt in folgenden Situationen nicht die neueste CLR-Version zurück:

Es ist eine Anwendungskonfigurationsdatei vorhanden, die das Laden einer bestimmten CLR-Version angibt. Beachten Sie, dass .NET Framework die Konfigurationsdatei auch dann verwendet, wenn für den pConfigurationFile-Parameter NULL angegeben wird.
Die CorBindToRuntimeEx-Methode wurde unter Angabe einer früheren CLR-Version aufgerufen.
Eine Anwendung, die für eine frühere CLR-Version kompiliert wurde, wird derzeit ausgeführt.

Für den runtimeInfoFlags-Parameter kann immer nur eine der Architekturkonstanten der RUNTIME_INFO_FLAGS-Enumeration angegeben werden:

RUNTIME_INFO_REQUEST_IA64
RUNTIME_INFO_REQUEST_AMD64
RUNTIME_INFO_REQUEST_X86

Anforderungen

Plattformen: Informationen finden Sie unter Systemanforderungen.

Header: MSCorEE.h

Bibliothek: MSCorEE.dll

.NET Framework-Versionen: Seit Version 1.1 verfügbar

Freigeben über