ICorRuntimeHost::CreateDomainEx-Methode

Artikel
08/10/2011

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.