GetRequestedRuntimeInfo-Funktion

Artikel
08/10/2011

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

Diese Funktion ist in .NET Framework, Version 4 veraltet.

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 Laufzeit angibt.
pConfigurationFile
[in] Der Name der Konfigurationsdatei, die pExe zugeordnet ist.
startupFlags
[in] Einer oder mehrere STARTUP_FLAGS-Enumerationswerte.
runtimeInfoFlags
[in] Einer oder mehrere RUNTIME_INFO_FLAGS-Enumerationswerte.
pDirectory
[out] Ein Puffer, der bei erfolgreichem Abschluss den Verzeichnispfad der Common Language Runtime enthält.
dwDirectory
[in] Die Länge des Verzeichnispuffers.
dwDirectoryLength
[out] Ein Zeiger auf die Länge der Zeichenfolge für den Verzeichnispfad.
pVersion
[out] Ein Puffer, der bei erfolgreichem Abschluss die Versionsnummer der Common Language 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 COM-Standardfehlercodes (Component Object Model) zurück, die zusätzlich zu den folgenden Werten in WinError.h definiert sind.

Rückgabecode	Beschreibungen
S_OK	Die Methode wurde erfolgreich abgeschlossen.
ERROR_INSUFFICIENT_BUFFER	Die Größe des Verzeichnispuffers reicht nicht aus, um den Verzeichnispfad zu speichern. - oder - Die Größe des Versionspuffers reicht nicht aus, um die Versionszeichenfolge zu speichern.

S_OK

Die Methode wurde erfolgreich abgeschlossen.

ERROR_INSUFFICIENT_BUFFER

Die Größe des Verzeichnispuffers reicht nicht aus, um den Verzeichnispfad zu speichern.

- oder -

Die Größe des Versionspuffers reicht nicht aus, um die Versionszeichenfolge zu speichern.

Hinweise

Die GetRequestedRuntimeInfo-Methode gibt Laufzeitinformationen zur Version zurück, die in den Prozess geladen ist. Es muss sich dabei nicht zwangsläufig um die neueste auf dem Computer installierte Version handeln.

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

Geben Sie die Parameter pExe, pwszVersion und 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 den folgenden Umständen nicht zurück:

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

Sie können für den runtimeInfoFlags-Parameter jeweils nur eine Architekturkonstante von RUNTIME_INFO_FLAGS laden: