Udostępnij za pośrednictwem

CorBindToRuntimeHost — Funkcja

  • Artykuł

Umożliwia hostom ładowanie określonej wersji środowiska uruchomieniowego języka wspólnego (CLR) do procesu.

Ta funkcja została przestarzała w .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
[w] Ciąg opisujący wersję środowiska CLR, który ma zostać załadowany.

Numer wersji w .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", po którym następują pierwsze trzy części numeru wersji (na przykład "v1.0.1529").

Niektóre wersje środowiska CLR są instalowane z instrukcją zasad, która określa zgodność z poprzednimi wersjami środowiska CLR. Domyślnie podkładka uruchamiania oblicza instrukcje zasad i ładuje pwszVersion najnowszą wersję środowiska uruchomieniowego zgodnego z żądaną wersją. Host może wymusić pominięcie oceny zasad i załadowanie dokładnej wersji określonej przez pwszVersion przekazanie wartości STARTUP_LOADER_SAFEMODE dla parametru startupFlags .

Jeśli pwszVersion metoda null, nie ładuje żadnej wersji środowiska CLR. Zamiast tego zwraca CLR_E_SHIM_RUNTIMELOAD, co oznacza, że nie można załadować środowiska uruchomieniowego.

pwszBuildFlavor
[w] Ciąg określający, czy załadować serwer, czy stację roboczą kompilacji środowiska 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. Podczas 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ść svr i określono współbieżne odzyskiwanie pamięci (zobacz opis parametru startupFlags ), kompilacja serwera jest ładowana.

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 systemu Windows WOW64 w systemach 64-bitowych, zobacz Uruchamianie aplikacji 32-bitowych.

pwszHostConfigFile
[w] 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, zakłada się, że plik znajduje się w tym samym katalogu co plik wykonywalny, który wykonuje wywołanie.

pReserved
[w] Zarezerwowane dla przyszłej rozszerzalności.

startupFlags
[w] 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 żadnej flagi. Aby uzyskać listę obsługiwanych wartości, zobacz STARTUP_FLAGS wyliczenie.

rclsid
[w] Klasa CLSID coclass implementuje interfejs ICorRuntimeHost lub ICLRRuntimeHost . Obsługiwane wartości są CLSID_CorRuntimeHost lub CLSID_CLRRuntimeHost.

riid
[w] Żądany IID interfejs. Obsługiwane wartości są 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łówka: MSCorEE.idl

Biblioteka: MSCorEE.dll

wersje .NET Framework: dostępne od wersji 1.0

Zobacz też