Udostępnij za pośrednictwem

ICorRuntimeHost::CreateDomainEx — Metoda

  • Artykuł

Tworzy domenę aplikacji. Obiekt wywołujący odbiera wskaźnik interfejsu typu _AppDomain, do wystąpienia typu System.AppDomain. Ta metoda umożliwia obiektowi wywołującego przekazanie wystąpienia IAppDomainSetup w celu skonfigurowania dodatkowych funkcji zwróconego _AppDomain wystąpienia.

Składnia

HRESULT CreateDomainEx (  
    [in] LPCWSTR     pwzFriendlyName,  
    [in] IUnknown*   pSetup,  
    [in] IUnknown*   pIdentityArray,  
    [out] IUnknown** pAppDomain  
);

Parametry

pwzFriendlyName
[w] Opcjonalny parametr służący do nadania przyjaznej nazwy domenie. Ta przyjazna nazwa może być wyświetlana w interfejsach użytkownika, takich jak debugery w celu zidentyfikowania domeny.

pSetup
[w] Opcjonalny wskaźnik interfejsu typu IAppDomainSetup, uzyskany przez wywołanie metody ICorRuntimeHost::CreateDomainSetup .

pIdentityArray
[w] Opcjonalna tablica wskaźników do IIdentity wystąpień reprezentujących dowody mapowane za pomocą zasad zabezpieczeń w celu ustanowienia zestawu uprawnień. IIdentity Obiekt można uzyskać, wywołując metodę CreateEvidence.

pAppDomain
[out] Wskaźnik interfejsu typu _AppDomain do wystąpienia System.AppDomain , którego można użyć do dalszej kontroli domeny.

Wartość zwracana

HRESULT Opis
S_OK Operacja zakończyła się pomyślnie.
S_FALSE Operacja nie powiodła się.
E_FAIL Wystąpił nieznany, katastrofalny błąd. Jeśli metoda zwróci E_FAIL, środowisko uruchomieniowe języka wspólnego (CLR) nie będzie już używane w procesie. Kolejne wywołania wszystkich interfejsów API hostingu zwracają HOST_E_CLRNOTAVAILABLE.
HOST_E_CLRNOTAVAILABLE ClR nie został załadowany do procesu lub CLR jest w stanie, w którym nie może uruchomić kodu zarządzanego ani pomyślnie przetworzyć wywołania.

Uwagi

CreateDomainEx Rozszerza możliwości elementu CreateDomain , umożliwiając obiektowi wywołującego przekazywanie w IAppDomainSetup wystąpieniu wartości właściwości do konfigurowania domeny aplikacji.

Wymagania

Platformy: Zobacz Wymagania systemowe.

Nagłówka: MSCorEE.h

Biblioteki: Uwzględnione jako zasób w MSCorEE.dll

.NET Framework wersja: 1.0, 1.1

Zobacz też