ICorRuntimeHost::CreateDomainEx, méthode

Article
08/21/2008

Mise à jour : novembre 2007

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 davantage de fonctions de l'instance _AppDomain retournée.

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

Paramètres

pwzFriendlyName
[in] Paramètre facultatif permettant de donner un nom convivial au domaine. Ce nom convivial peut s'afficher dans les interfaces utilisateur telles que 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 à des instances IIdentity qui représentent la preuve mappée à travers une stratégie de sécurité pour é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 qui permet de 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 grave et inconnue 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 à toute API d'hébergement retournent HOST_E_CLRNOTAVAILABLE.
HOST_E_CLRNOTAVAILABLE	Le 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

CreateDomainEx étend les fonctions de CreateDomain en permettant à l'appelant de passer une instance IAppDomainSetup avec les valeurs de propriété utilisées pour configurer le domaine d'application.