Metodo ICLRDomainManager::SetAppDomainManagerType

Articolo
08/11/2011

Specifica il tipo, derivato dalla classe System.AppDomainManager del gestore del dominio applicazione che verrà utilizzato per inizializzare il dominio applicazione predefinito.

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

Parametri

wszAppDomainManagerAssembly
[in] Il nome visualizzato dell'assembly che contiene il tipo di gestore di dominio applicazione; ad esempio: "AdMgrExample, Version=1 .0.0.0, Culture=neutral, PublicKeyToken=6856bccf150f00b3".
wszAppDomainManagerType
[in] Il nome del tipo di gestore del dominio applicazione, incluso lo spazio dei nomi.
dwInitializeDomainFlags
[in] Una combinazione di valori di enumerazione EInitializeNewDomainFlags che fornisce informazioni sul gestore di dominio applicazione.

Valore restituito

Questo metodo restituisce gli HRESULT specifici seguenti nonché gli errori HRESULT che indicano l'esito negativo del metodo.

HRESULT	Oggetto di descrizione
S_OK	Il metodo è stato eseguito correttamente.
HOST_E_CLRNOTAVAILABLE	Common Language Runtime non è stato caricato in un processo oppure si trova in uno stato in cui non è possibile eseguire codice gestito né elaborare correttamente la chiamata.

Note

Attualmente, l'unico valore definito per dwInitializeDomainFlags è eInitializeNewDomainFlags_NoSecurityChanges che indica al Common Language Runtime (CLR) che il gestore di dominio applicazione non modificherà le impostazioni di sicurezza durante l'esecuzione del metodo AppDomainManager.InitializeNewDomain. Consente a CLR di ottimizzare il caricamento di assembly che dispongono dell'attributo AllowPartiallyTrustedCallersAttribute (APTCA) condizionale. Questo può comportare un miglioramento significativo del tempo di avvio se la chiusura del transitivo di questo set di assembly è grande.

Importante
Se l'host specifica eInitializeNewDomainFlags_NoSecurityChanges per il gestore di dominio applicazione, InvalidOperationException viene generato se si tenta di modificare la sicurezza del dominio applicazione.

Chiamare il metodo ICLRControl::SetAppDomainManagerType equivale a chiamare ICLRDomainManager::SetAppDomainManagerType con eInitializeNewDomainFlags_None.