ICLRDomainManager::SetAppDomainManagerType, méthode

Article
05/10/2023

Spécifie le type, dérivé de la classe System.AppDomainManager, du gestionnaire de domaine d’application qui sera utilisé pour initialiser le domaine d’application par défaut.

Syntaxe

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

Paramètres

wszAppDomainManagerAssembly
[in] Nom d’affichage de l’assembly qui contient le type du gestionnaire de domaine d’application ; par exemple : « AdMgrExample, Version=1.0.0.0, Culture=neutral, PublicKeyToken=6856bccf150f00b3 ».

wszAppDomainManagerType
[in] Nom de type du gestionnaire de domaine d’application, y compris l’espace de noms.

dwInitializeDomainFlags
[in] Combinaison de valeurs d’énumération EInitializeNewDomainFlags qui fournissent des informations sur le gestionnaire de domaine d’application.

Valeur de retour

Cette méthode retourne les HRESULT spécifiques suivants ainsi que les erreurs HRESULT indiquant l'échec de la méthode.

HRESULT	Description
S_OK	La commande s'est correctement terminée.
HOST_E_CLRNOTAVAILABLE	Le Common Language Runtime (CLR) n’a pas été chargé dans un processus ou est dans un état dans lequel il ne peut ni exécuter le code managé ni traiter l’appel.

Notes

Actuellement, la seule valeur définie pour dwInitializeDomainFlags est eInitializeNewDomainFlags_NoSecurityChanges, qui indique au Common Language Runtime (CLR) que le gestionnaire de domaine d’application ne modifie pas les paramètres de sécurité pendant l’exécution de la méthode AppDomainManager.InitializeNewDomain. Le CLR peut ainsi optimiser le chargement des assemblys qui ont l’attribut conditionnel AllowPartiallyTrustedCallersAttribute (APTCA). Cela peut entraîner une amélioration significative du temps de démarrage si la fermeture transitive de cet ensemble d’assemblys est importante.

Important

Si l’hôte spécifie eInitializeNewDomainFlags_NoSecurityChanges pour le gestionnaire de domaine d’application, une exception InvalidOperationException est levée en cas de tentative de modification de la sécurité du domaine d’application.

Appeler la méthode ICLRControl::SetAppDomainManagerType équivaut à appeler ICLRDomainManager::SetAppDomainManagerType avec eInitializeNewDomainFlags_None.

Spécifications

Plateformes : Consultez Configuration requise.

En-tête : MetaHost.h

Bibliothèque : incluse en tant que ressource dans MsCorEE.dll

Versions de .NET Framework : Disponibles depuis 4

Partager via