ICLRDomainManager::SetAppDomainManagerType 方法

發行項
08/12/2011

指定將用於初始化預設應用程式定義域的應用程式定義域管理員 (衍生 System.AppDomainManager 類別) 的類型。

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

參數

wszAppDomainManagerAssembly
[內] 包含應用程式定義域管理員類型之組件的顯示名稱，例如"AdMgrExample, Version=1.0.0.0, Culture=neutral, PublicKeyToken=6856bccf150f00b3"。
wszAppDomainManagerType
[內] 應用程式定義域管理員的型別名稱，包括命名空間。
dwInitializeDomainFlags
[內] EInitializeNewDomainFlags 列舉值的組合，可提供應用程式定義域管理員的相關資訊。

傳回值

這個方法會傳回下列特定的 HRESULT，以及表示方法失敗的 HRESULT 錯誤。

HRESULT	描述
S_OK	此方法已成功完成。
HOST_E_CLRNOTAVAILABLE	Common Language Runtime (CLR) 尚未載入至處理序中，或者此 CLR 目前的狀態無法執行 Managed 程式碼或成功處理呼叫。

備註

目前，dwInitializeDomainFlags 唯一的定義值為 eInitializeNewDomainFlags_NoSecurityChanges，它會通知 Common Language Runtime (CLR) 應用程式定義域管理員不會在 AppDomainManager.InitializeNewDomain 方法執行期間修改安全性設定。這可讓 CLR 最佳化載入具有條件式 AllowPartiallyTrustedCallersAttribute (APTCA) 屬性的組件。如果這一組組件的 Transitive 關閉很大，這可能會大幅改善啟動時間。

重要事項
如果主機指定應用程式定義域管理員的 eInitializeNewDomainFlags_NoSecurityChanges，若常是修改應用程式定義域的安全性，則會擲回 InvalidOperationException。