ICLRDomainManager::SetAppDomainManagerType, méthode

Article
08/10/2011

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.

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

Paramètres

wszAppDomainManagerAssembly
[in] Le nom complet de l'assembly qui contient le type de gestionnaire de domaine d'application ; par exemple: « AdMgrExample, Version=1.0.0.0, Culture=neutral, PublicKeyToken=6856bccf150f00b3 ».
wszAppDomainManagerType
[in] Le nom de type du gestionnaire de domaine d'application, y compris l'espace de noms.
dwInitializeDomainFlags
[in] A combinaison des valeurs d'énumération EInitializeNewDomainFlags qui fournissent les informations à propos du gestionnaire de domaine d'application.

Valeur de retour

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

HRESULT	Description
S_OK	La méthode s'est correctement terminée.
HOST_E_CLRNOTAVAILABLE	Le Common Language Runtime (CLR) n'a pas été chargé dans un processus ou le CLR présente un état dans lequel il ne peut pas exécuter de code managé ou traiter l'appel avec succès.

Notes

Actuellement, la seule valeur définie pour dwInitializeDomainFlags est eInitializeNewDomainFlags_NoSecurityChanges, qui indique au CLR que le gestionnaire de domaine d'application ne modifiera pas de paramètres de sécurité pendant l'exécution de la méthode AppDomainManager.InitializeNewDomain. Cela permet au CLR d'optimiser le chargement des assemblys qui ont l'attribut AllowPartiallyTrustedCallersAttribute (APTCA) conditionnel. Cela peut provoquer une amélioration significative du temps de démarrage si la fermeture transitive de ce jeu d'assemblys est importante.

Important
Si l'hôte spécifie eInitializeNewDomainFlags_NoSecurityChanges pour le gestionnaire de domaine d'application, un InvalidOperationException est levé si une tentative est faite pour modifier la sécurité du domaine d'application.

L'appel de la méthode ICLRControl::SetAppDomainManagerType est équivalent à ICLRDomainManager::SetAppDomainManagerType à l'appel de eInitializeNewDomainFlags_None.