Freigeben über


ICorRuntimeHost::CreateDomainEx-Methode

Erstellt eine Anwendungsdomäne. Der Aufrufer empfängt einen Schnittstellenzeiger des Typs _AppDomain auf eine Instanz des Typs System.AppDomain. Diese Methode ermöglicht dem Aufrufer die Übergabe einer IAppDomainSetup-Instanz, um weitere Features der zurückgegebenen _AppDomain-Instanz zu konfigurieren.

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

Parameter

  • pwzFriendlyName
    [in] Ein optionaler Parameter, der verwendet wird, um der Domäne einen angezeigten Namen zuzuweisen. Dieser Name kann in Benutzeroberflächen, zum Beispiel in Debuggern, angezeigt werden, um die Domäne zu identifizieren.

  • pSetup
    [in] Ein optionaler Schnittstellenzeiger des Typs IAppDomainSetup, der durch einen Aufruf der ICorRuntimeHost::CreateDomainSetup-Methode abgerufen wird.

  • pIdentityArray
    [in] Ein optionales Array von Zeigern auf IIdentity-Instanzen, die Beweise darstellen, die von der Sicherheitsrichtlinie zum Erstellen eines Berechtigungssatzes zugeordnet werden. Ein IIdentity-Objekt kann durch Aufruf der CreateEvidence-Methode abgerufen werden.

  • pAppDomain
    [out] Ein Schnittstellenzeiger vom Typ _AppDomain auf eine Instanz von System.AppDomain, die zur weiteren Steuerung der Domäne verwendet werden kann.

Rückgabewert

HRESULT

Beschreibungen

S_OK

Der Vorgang wurde erfolgreich ausgeführt.

S_FALSE

Der Vorgang konnte nicht erfolgreich beendet werden.

E_FAIL

Ein unbekannter, schwerwiegender Fehler ist aufgetreten. Wenn eine Methode E_FAIL zurückgibt, kann die Common Language Runtime (CLR) im Prozess nicht mehr verwendet werden. Nachfolgende Aufrufe einer beliebigen Hosting-API geben HOST_E_CLRNOTAVAILABLE zurück.

HOST_E_CLRNOTAVAILABLE

Die CLR wurde nicht in einen Prozess geladen oder befindet sich in einem Zustand, in dem sie weder verwalteten Code ausführen noch den Aufruf erfolgreich verarbeiten kann.

Hinweise

CreateDomainEx erweitert die Funktionalität von CreateDomain, indem dem Aufrufer erlaubt wird, eine IAppDomainSetup-Instanz mit Eigenschaftswerten zur Konfiguration der Anwendungsdomäne zu übergeben.

Anforderungen

Plattformen: siehe Systemanforderungen für .NET Framework.

Header: MSCorEE.h

Bibliothek: als Ressource in MSCorEE.dll enthalten

.NET Framework-Version: 1.0, 1.1

Siehe auch

Referenz

_AppDomain

AppDomain

ICorRuntimeHost::CreateDomain-Methode

IAppDomainSetup-Schnittstelle

ICorRuntimeHost-Schnittstelle

System.IAppDomainSetup