CorBindToRuntimeHost — Funkcja
Umożliwia hostom ładowanie określonej wersji środowiska uruchomieniowego języka wspólnego (CLR) do procesu.
Ta funkcja została uznana za przestarzałą w programie .NET Framework 4.
Składnia
HRESULT CorBindToRuntimeHost (
[in] LPCWSTR pwszVersion,
[in] LPCWSTR pwszBuildFlavor,
[in] LPCWSTR pwszHostConfigFile,
[in] VOID* pReserved,
[in] DWORD startupFlags,
[in] REFCLSID rclsid,
[in] REFIID riid,
[out] LPVOID FAR *ppv
);
Parametry
pwszVersion
[in] Ciąg opisujący wersję środowiska CLR, którą chcesz załadować.
Numer wersji w programie .NET Framework składa się z czterech części rozdzielonych kropkami: major.minor.build.revision. Ciąg przekazany jako pwszVersion musi zaczynać się od znaku "v", a następnie pierwszych trzech części numeru wersji (na przykład "v1.0.1529").
Niektóre wersje środowiska CLR są instalowane za pomocą instrukcji zasad, która określa zgodność z poprzednimi wersjami środowiska CLR. Domyślnie podkładka uruchamiania oblicza instrukcje pwszVersion zasad i ładuje najnowszą wersję środowiska uruchomieniowego zgodnego z żądaną wersją. Host może wymusić pominięcie oceny zasad i załadowanie dokładnej wersji określonej w pwszVersion programie przez przekazanie wartości STARTUP_LOADER_SAFEMODE dla parametru startupFlags .
Jeśli pwszVersion parametr ma nullwartość , metoda nie ładuje żadnej wersji środowiska CLR. Zamiast tego zwraca CLR_E_SHIM_RUNTIMELOAD, co oznacza, że nie można załadować środowiska uruchomieniowego.
pwszBuildFlavor
[in] Ciąg, który określa, czy załadować serwer, czy stację roboczą kompilacji CLR. Prawidłowe wartości to svr i wks. Kompilacja serwera jest zoptymalizowana pod kątem korzystania z wielu procesorów na potrzeby odzyskiwania pamięci, a kompilacja stacji roboczej jest zoptymalizowana pod kątem aplikacji klienckich działających na maszynie z jednym procesorem.
Jeśli pwszBuildFlavor ustawiono wartość null, zostanie załadowana kompilacja stacji roboczej. W przypadku uruchamiania na maszynie z jednym procesorem kompilacja stacji roboczej jest zawsze ładowana, nawet jeśli pwszBuildFlavor jest ustawiona na svrwartość . Jeśli pwszBuildFlavor jednak ustawiono wartość i svr określono współbieżne odzyskiwanie pamięci (zobacz opis parametru startupFlags ), zostanie załadowana kompilacja serwera.
Uwaga
Współbieżne odzyskiwanie pamięci nie jest obsługiwane w aplikacjach z emulatorem WOW64 x86 w systemach 64-bitowych, które implementują architekturę Intel Itanium (dawniej IA-64). Aby uzyskać więcej informacji na temat korzystania z WOW64 w 64-bitowych systemach Windows, zobacz Running 32-bit Applications (Uruchamianie aplikacji 32-bitowych).
pwszHostConfigFile
[in] Nazwa pliku konfiguracji hosta, który określa wersję środowiska CLR do załadowania. Jeśli nazwa pliku nie zawiera w pełni kwalifikowanej ścieżki, przyjmuje się, że plik znajduje się w tym samym katalogu co plik wykonywalny, który wykonuje wywołanie.
pReserved
[in] Zarezerwowane dla przyszłej rozszerzalności.
startupFlags
[in] Zestaw flag, które sterują współbieżnym odzyskiwaniem pamięci, kodem neutralnym dla domeny i zachowaniem parametru pwszVersion . Wartość domyślna to pojedyncza domena, jeśli nie ustawiono flagi. Aby uzyskać listę obsługiwanych wartości, zobacz wyliczenie STARTUP_FLAGS.
rclsid
[in] Klasa CLSID coclass, która implementuje interfejs ICorRuntimeHost lub ICLRRuntimeHost . Obsługiwane wartości to CLSID_CorRuntimeHost lub CLSID_CLRRuntimeHost.
riid
[in] Żądany IID interfejs. Obsługiwane wartości to IID_ICorRuntimeHost lub IID_ICLRRuntimeHost.
ppv
[out] Wskaźnik interfejsu do wersji środowiska uruchomieniowego, który został załadowany.
Wymagania
Platformy: zobacz Wymagania systemowe.
Nagłówek: MSCorEE.idl
Biblioteka: MSCorEE.dll
Wersje programu .NET Framework: dostępne od wersji 1.0
