Metodo ICorRuntimeHost::CreateDomainEx

Articolo
08/11/2011

Crea un dominio applicazione. Il chiamante riceve un puntatore a interfaccia, di tipo _AppDomain, a un'istanza di tipo System.AppDomain. Questo metodo consente al chiamante di passare un'istanza di IAppDomainSetup per configurare ulteriori funzionalità dell'istanza di _AppDomain restituita.

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

Parametri

pwzFriendlyName
[in] Parametro facoltativo utilizzato per assegnare un nome descrittivo al dominio. Questo nome può essere visualizzato nelle interfacce utente, ad esempio i debugger, per identificare il dominio.
pSetup
[in] Puntatore a interfaccia facoltativo di tipo IAppDomainSetup, ottenuto tramite una chiamata al metodo ICorRuntimeHost::CreateDomainSetup.
pIdentityArray
[in] Matrice facoltativa di puntatori a istanze di IIdentity che rappresentano evidenze mappate tramite criteri di sicurezza per la definizione di un set di autorizzazioni. Un oggetto IIdentity può essere ottenuto chiamando il metodo CreateEvidence.
pAppDomain
[out] Puntatore a interfaccia di tipo _AppDomain a un'istanza di System.AppDomain che può essere utilizzato per fornire un ulteriore controllo sul dominio.

Valore restituito

HRESULT	Oggetto di descrizione
S_OK	L'operazione è stata completata.
S_FALSE	L'operazione non è stata completata.
E_FAIL	Si è verificato un errore grave sconosciuto. Se un metodo restituisce E_FAIL, non sarà più possibile utilizzare Common Language Runtime all'interno del processo. Le chiamate successive a qualsiasi API di hosting restituiranno HOST_E_CLRNOTAVAILABLE.
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

CreateDomainEx estende le funzionalità di CreateDomain consentendo al chiamante di passare un'istanza di IAppDomainSetup con valori di proprietà per configurare il dominio dell'applicazione.