ICorRuntimeHost::CreateDomainEx, méthode

Article
05/10/2023

Crée un domaine d’application. L’appelant reçoit un pointeur d’interface de type _AppDomain vers une instance de type System.AppDomain. Cette méthode permet à l’appelant de passer une instance IAppDomainSetup pour configurer des fonctionnalités supplémentaires de l’instance _AppDomain retournée.

Syntaxe

HRESULT CreateDomainEx (  
    [in] LPCWSTR     pwzFriendlyName,  
    [in] IUnknown*   pSetup,  
    [in] IUnknown*   pIdentityArray,  
    [out] IUnknown** pAppDomain  
);

Paramètres

pwzFriendlyName
[in] Paramètre facultatif utilisé pour attribuer un nom convivial au domaine. Ce nom convivial peut s’afficher dans les interfaces utilisateur comme les débogueurs pour identifier le domaine.

pSetup
[in] Pointeur d’interface facultatif de type IAppDomainSetup, obtenu par un appel à la méthode ICorRuntimeHost::CreateDomainSetup.

pIdentityArray
[in] Tableau facultatif de pointeurs vers des instances IIdentity qui représentent une preuve mappée par le biais d’une stratégie de sécurité afin d’établir un jeu d’autorisations. Un objet IIdentity peut être obtenu en appelant la méthode CreateEvidence.

pAppDomain
[out] Pointeur d’interface de type _AppDomain vers une instance de System.AppDomain pouvant être utilisé pour contrôler davantage le domaine.

Valeur de retour

HRESULT	Description
S_OK	L'opération a réussi.
S_FALSE	Échec de l’opération.
E_FAIL	Une défaillance inconnue et catastrophique s’est produite. Si une méthode retourne E_FAIL, le Common Language Runtime (CLR) n’est plus utilisable dans le processus. Les appels suivants aux API d’hébergement retournent HOST_E_CLRNOTAVAILABLE.
HOST_E_CLRNOTAVAILABLE	Le 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

CreateDomainEx étend les fonctionnalités de CreateDomain en autorisant l’appelant à passer une instance IAppDomainSetup avec des valeurs de propriété pour configurer le domaine d’application.

Configuration requise

Plateformes : Consultez Configuration requise.

En-tête : MSCorEE.h

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

Version de .NET Framework : 1.0, 1.1

Partager via