GetRequestedRuntimeInfo, funkcja

Pobiera informacje o wersji i katalogu dotyczące środowiska uruchomieniowego języka wspólnego (CLR) żądane przez aplikację.

Ta funkcja została uznana za przestarzałą w programie .NET Framework 4.

Składnia

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

Parametry

pExe [in] Nazwa aplikacji.

pwszVersion [in] Ciąg określający numer wersji środowiska uruchomieniowego.

pConfigurationFile [in] Nazwa pliku konfiguracji skojarzonego z pExeprogramem .

startupFlags [in] Co najmniej jedna z STARTUP_FLAGS wartości wyliczenia.

runtimeInfoFlags [in] Co najmniej jedna z wartości wyliczenia RUNTIME_INFO_FLAGS .

pDirectory [out] Bufor zawierający ścieżkę katalogu do środowiska uruchomieniowego po pomyślnym zakończeniu.

dwDirectory [in] Długość buforu katalogu.

dwDirectoryLength [out] Wskaźnik do długości ciągu ścieżki katalogu.

pVersion [out] Bufor zawierający numer wersji środowiska uruchomieniowego po pomyślnym zakończeniu.

cchBuffer [in] Długość buforu ciągu wersji.

dwlength [out] Wskaźnik do długości ciągu wersji.

Wartość zwracana

Ta metoda zwraca standardowe kody błędów modelu obiektów składników (COM), zgodnie z definicją w winError.h, oprócz następujących wartości.

Uwagi

Metoda GetRequestedRuntimeInfo zwraca informacje o wersji środowiska uruchomieniowego załadowane do procesu, która niekoniecznie jest najnowszą wersją zainstalowaną na komputerze.

W programie .NET Framework w wersji 2.0 można uzyskać informacje o najnowszej zainstalowanej wersji przy użyciu GetRequestedRuntimeInfo metody w następujący sposób:

• pExeOkreśl parametry , pwszVersioni pConfigurationFile jako null.

• Określ flagę RUNTIME_INFO_UPGRADE_VERSION w wyliczeniach RUNTIME_INFO_FLAGS parametru runtimeInfoFlags .

Metoda GetRequestedRuntimeInfo nie zwraca najnowszej wersji środowiska CLR w następujących okolicznościach:

• Plik konfiguracji aplikacji określający ładowanie określonej wersji środowiska CLR istnieje. Należy pamiętać, że program .NET Framework będzie używać pliku konfiguracji, nawet jeśli określisz wartość null dla parametru pConfigurationFile .

• Metoda CorBindToRuntimeEx została wywołana określającą wcześniejszą wersję środowiska CLR.

• Aplikacja, która została skompilowana dla starszej wersji środowiska CLR, jest obecnie uruchomiona.

Dla parametru runtimeInfoFlags można określić tylko jedną z stałych RUNTIME_INFO_FLAGS architektury wyliczenia w danym momencie:

• RUNTIME_INFO_REQUEST_IA64

• RUNTIME_INFO_REQUEST_AMD64

• RUNTIME_INFO_REQUEST_X86

Requirements

Platformy: Zobacz Wymagania systemowe.

Nagłówek: MSCorEE.h

Biblioteka: MSCorEE.dll

Wersje programu .NET Framework: Dostępne od wersji 1.1

Zobacz także

• GetRequestedRuntimeVersion, funkcja
• GetVersionFromProcess, funkcja
• Przestarzałe funkcje hostingu CLR