ICorRuntimeHost::CreateDomainEx 方法

發行項
08/12/2011

建立應用程式定義域。呼叫端會收到型別為 _AppDomain 的介面指標，指向 System.AppDomain 型別的執行個體。此方法允許呼叫端傳遞 IAppDomainSetup 執行個體，以便為傳回的 _AppDomain 執行個體設定其他功能。

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

參數

pwzFriendlyName
[in] 用來為定義域提供易記名稱的選擇性參數。此易記名稱可以顯示在類似偵錯工具的使用者介面上，以識別該定義域。
pSetup
[in] 型別為 IAppDomainSetup 的選用介面指標，可透過呼叫 ICorRuntimeHost::CreateDomainSetup 方法來取得。
pIdentityArray
[in] IIdentity 執行個體指標的選擇性陣列，這些執行個體表示透過安全性原則所對應的辨識項 (用來建立使用權限集合)。可藉由呼叫 CreateEvidence 方法，取得 IIdentity 物件。
pAppDomain
[out] 型別為 _AppDomain 的介面指標，指向可用來進一步控制定義域的 System.AppDomain 執行個體。

傳回值

HRESULT	描述
S_OK	作業完成。
S_FALSE	作業無法完成。
E_FAIL	發生未知且嚴重的失敗。如果方法傳回 E_FAIL，處理序中就無法再使用 Common Language Runtime (CLR)。對任何裝載 API 的後續呼叫會傳回 HOST_E_CLRNOTAVAILABLE。
HOST_E_CLRNOTAVAILABLE	CLR 尚未載入至處理序中，或者此 CLR 目前的狀態無法執行 Managed 程式碼或成功處理呼叫。