Freigeben über

GetRequestedRuntimeInfo-Funktion

Ruft Versions- und Verzeichnisinformationen über die von einer Anwendung angeforderte Common Language Runtime (CLR) ab.

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

Die Parameter

pExe [in] Der Name der Anwendung.

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

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

startupFlags [in] Mindestens einer der STARTUP_FLAGS Enumerationswerte.

runtimeInfoFlags [in] Mindestens einer der RUNTIME_INFO_FLAGS Enumerationswerte.

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

dwDirectory [in] Die Länge des Verzeichnispuffers.

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

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

cchBuffer [in] Die Länge des Versionszeichenfolgenpuffers.

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

Rückgabewert

Diese Methode gibt zusätzlich zu den folgenden Werten standardmäßige COM-Fehlercodes (Component Object Model) zurück, wie in WinError.h definiert.

Rückgabecode Description
S_OK Die Methode wurde erfolgreich abgeschlossen.
FEHLER_UNZUREICHENDER_PUFFER 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 über die in den Prozess geladene Version zurück, bei der es sich nicht unbedingt um die neueste auf dem Computer installierte Version handelt.

In .NET Framework, Version 2.0, können Sie Informationen über die neueste installierte Version abrufen, indem Sie die GetRequestedRuntimeInfo Methode wie folgt verwenden:

  • Geben Sie die pExeParameter pwszVersionund Parameter pConfigurationFile als NULL an.

  • Geben Sie das RUNTIME_INFO_UPGRADE_VERSION Flag in den RUNTIME_INFO_FLAGS Enumerationen für den runtimeInfoFlags Parameter an.

Die GetRequestedRuntimeInfo Methode gibt die neueste CLR-Version unter folgenden Umständen nicht zurück:

  • Eine Anwendungskonfigurationsdatei, die angibt, dass eine bestimmte CLR-Version geladen wird. Beachten Sie, dass .NET Framework die Konfigurationsdatei auch dann verwendet, wenn Sie null für den pConfigurationFile Parameter angeben.

  • Die CorBindToRuntimeEx-Methode wurde aufgerufen, um eine frühere CLR-Version anzugeben.

  • Derzeit wird eine Anwendung ausgeführt, die für eine frühere CLR-Version kompiliert wurde.

Für den runtimeInfoFlags Parameter können Sie jeweils nur eine der Architekturkonstanten der RUNTIME_INFO_FLAGS Enumeration angeben:

  • RUNTIME_INFO_REQUEST_IA64

  • RUNTIME_INFO_REQUEST_AMD64

  • RUNTIME_INFO_REQUEST_X86

Anforderungen

Plattformen: Informationen finden Sie unter Systemanforderungen.

Kopfball: MSCorEE.h

Bibliothek: MSCorEE.dll

.NET Framework-Versionen: Verfügbar seit 1.1

Siehe auch

  • Last updated on