ICorRuntimeHost::CreateDomainEx – metoda

Článek
05/10/2023

Vytvoří doménu aplikace. Volající obdrží ukazatel rozhraní typu _AppDomainna instanci typu System.AppDomain. Tato metoda umožňuje volajícímu předat instanci IAppDomainSetup ke konfiguraci dalších funkcí vrácené _AppDomain instance.

Syntaxe

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

Parametry

pwzFriendlyName
[v] Volitelný parametr, který slouží k určení popisného názvu domény. Tento popisný název lze zobrazit v uživatelských rozhraních, jako jsou ladicí programy, a identifikovat tak doménu.

pSetup
[v] Volitelný ukazatel rozhraní typu IAppDomainSetup, získaný voláním metody ICorRuntimeHost::CreateDomainSetup .

pIdentityArray
[v] Volitelné pole ukazatelů na IIdentity instance, které představují důkazy namapované prostřednictvím zásad zabezpečení k vytvoření sady oprávnění. Objekt IIdentity lze získat voláním Metody CreateEvidence .

pAppDomain
[out] Ukazatel rozhraní typu _AppDomain na instanci System.AppDomain , který lze použít k dalšímu řízení domény.

Návratová hodnota

HRESULT	Description
S_OK	Operace byla úspěšná.
S_FALSE	Operaci se nepodařilo dokončit.
E_FAIL	Došlo k neznámému katastrofickému selhání. Pokud metoda vrátí E_FAIL, modul CLR (Common Language Runtime) už není v procesu použitelný. Následná volání všech rozhraní API pro hostování vrátí HOST_E_CLRNOTAVAILABLE.
HOST_E_CLRNOTAVAILABLE	ClR nebyl načten do procesu nebo clr je ve stavu, ve kterém nemůže spustit spravovaný kód nebo úspěšně zpracovat volání.

Poznámky

CreateDomainEx rozšiřuje možnosti CreateDomain tím, že umožňuje volajícímu předat IAppDomainSetup instanci s hodnotami vlastností pro konfiguraci domény aplikace.

Požadavky

Platformy: Viz Požadavky na systém.

Záhlaví: MSCorEE.h

Knihovny: Zahrnutý jako prostředek v MSCorEE.dll

Verze rozhraní .NET Framework: 1.0, 1.1

Sdílet prostřednictvím