Udostępnij za pośrednictwem

GetRequestedRuntimeInfo — Funkcja

  • Artykuł

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

Ta funkcja została przestarzała w .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
[w] Nazwa aplikacji.

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

pConfigurationFile
[w] Nazwa pliku konfiguracji skojarzonego z pExeprogramem .

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

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

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

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

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

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

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

dwlength
[out] Wskaźnik 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 metodzie WinError.h oprócz następujących wartości.

Kod powrotu Opis
S_OK Metoda została ukończona pomyślnie.
ERROR_INSUFFICIENT_BUFFER Bufor katalogu nie jest wystarczająco duży, aby przechowywać ścieżkę katalogu.

— lub —

Bufor wersji nie jest wystarczająco duży, aby przechowywać ciąg wersji.

Uwagi

Metoda GetRequestedRuntimeInfo zwraca informacje o czasie wykonywania dotyczące wersji załadowanej do procesu, która niekoniecznie jest najnowszą wersją zainstalowaną na komputerze.

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

  • pExeOkreśl parametry , pwszVersioni pConfigurationFile jako null.

  • Określ flagę RUNTIME_INFO_UPGRADE_VERSION w wyliczeń 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 .NET Framework użyje pliku konfiguracji, nawet jeśli określisz wartość null dla parametru pConfigurationFile .

  • Metoda CorBindToRuntimeEx nosiła nazwę określającą wcześniejszą wersję środowiska CLR.

  • Aplikacja skompilowana dla starszej wersji środowiska CLR jest obecnie uruchomiona.

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

  • RUNTIME_INFO_REQUEST_IA64

  • RUNTIME_INFO_REQUEST_AMD64

  • RUNTIME_INFO_REQUEST_X86

Wymagania

Platformy: Zobacz Wymagania systemowe.

Nagłówka: MSCorEE.h

Biblioteka: MSCorEE.dll

.NET Framework wersje: dostępne od wersji 1.1

Zobacz też