ICLRDomainManager::SetAppDomainManagerType-Methode

Artikel
08/10/2011

Gibt den Typ (von der System.AppDomainManager-Klasse abgeleitet) des Anwendungsdomänen-Managers an, der zur Initialisierung der Standardanwendungsdomäne dient.

HRESULT SetAppDomainManagerType(
    [in] LPCWSTR wszAppDomainManagerAssembly,
    [in] LPCWSTR wszAppDomainManagerType,
    [in] EInitializeNewDomainFlags dwInitializeDomainFlags
);

Parameter

wszAppDomainManagerAssembly
[in] Der Anzeigename der Assembly, die den Anwendungsdomänenmanager-Typ enthält; z. B.: "AdMgrExample, Version=1.0.0.0, Culture=neutral, PublicKeyToken=6856bccf150f00b3."
wszAppDomainManagerType
[in] Der Typname des Anwendungsdomänenmanagers, einschließlich des Namespace.
dwInitializeDomainFlags
[in] Eine Kombination von EInitializeNewDomainFlags-Enumerationswerten, die Informationen zum Anwendungsdomänen-Manager bereitstellen.

Rückgabewert

Diese Methode gibt die folgenden spezifischen HRESULTs sowie HRESULT-Fehler für Methodenfehler zurück.

HRESULT	Beschreibungen
S_OK	Die Methode wurde erfolgreich abgeschlossen.
HOST_E_CLRNOTAVAILABLE	Die Common Language Runtime (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

Aktuell ist der einzige definierte Wert für dwInitializeDomainFlagseInitializeNewDomainFlags_NoSecurityChanges, der der Common Language Runtime (CLR) mitteilt, dass der Anwendungsdomänen-Manager während der Ausführung der AppDomainManager.InitializeNewDomain-Methode keine Sicherheitseinstellungen ändert. Dies ermöglicht es der CLR, das Laden von Assemblys zu optimieren, die über das bedingte AllowPartiallyTrustedCallersAttribute (APTCA)-Attribut verfügen. Dies kann zu einer deutlichen Verbesserung der Startzeit führen, wenn der transitive Abschluss dieses Satzes von Assemblys groß ist.

Wichtig
Wenn der Host eInitializeNewDomainFlags_NoSecurityChanges für den Anwendungsdomänen-Manager angibt, wird ein InvalidOperationException ausgelöst, wenn versucht wird, die Sicherheit von der Anwendungsdomäne zu ändern.

Das Aufrufen der ICLRControl::SetAppDomainManagerType-Methode entspricht dem Aufrufen von ICLRDomainManager::SetAppDomainManagerType mit eInitializeNewDomainFlags_None.