Freigeben über


ICorRuntimeHost::CreateDomain-Methode

Erstellt eine Anwendungsdomäne. Der Aufrufer empfängt einen Schnittstellenzeiger vom Typ _AppDomain auf eine Instanz vom Typ System.AppDomain.

HRESULT CreateDomain (
    [in] LPWSTR    pwzFriendlyName,
    [in] IUnknown* pIdentityArray,
    [out] void   **pAppDomain
);

Parameter

  • pwzFriendlyName
    [in] Ein optionaler Parameter, mit dessen Hilfe der Domäne ein angezeigter Name zugewiesen wird. Dieser angezeigte Name kann in Benutzeroberflächen, z. B. Debuggern, angezeigt werden, um die Domäne zu identifizieren.

  • 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.

Anforderungen

Plattformen: siehe Systemanforderungen für .NET Framework.

Header: MSCorEE.h

Bibliothek: als Ressource in MSCorEE.dll enthalten

.NET Framework-Versionen: 1.0, 1.1

Siehe auch

Referenz

_AppDomain

AppDomain

ICorRuntimeHost-Schnittstelle