ICLRDomainManager::SetAppDomainManagerType メソッド
既定のアプリケーション ドメインを初期化するために使用するアプリケーション ドメイン マネージャーの型 (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 |
共通言語ランタイム (CLR: Common Language Runtime) がプロセスに読み込まれていません。または CLR がマネージ コードを実行できない状態か、呼び出しを正常に処理できない状態にあります。 |
解説
現在、dwInitializeDomainFlags に定義されている値は eInitializeNewDomainFlags_NoSecurityChanges だけです。この値は、共通言語ランタイム (CLR: Common Language Runtime) に対して、アプリケーション ドメイン マネージャーが AppDomainManager.InitializeNewDomain メソッドの実行時にセキュリティ設定を変更しないことを通知します。 CLR では、この機能により、条件付き AllowPartiallyTrustedCallersAttribute (APTCA) 属性を持つアセンブリの読み込みを最適化できるようになります。 その結果、このアセンブリ セットの推移的閉包が大きくなった場合に起動時間を大幅に短縮できます。
重要 |
---|
アプリケーション ドメイン マネージャーに対して eInitializeNewDomainFlags_NoSecurityChanges が指定されている場合に、アプリケーション ドメインのセキュリティを変更しようとすると、InvalidOperationException がスローされます。 |
ICLRControl::SetAppDomainManagerType メソッドを呼び出すことは、eInitializeNewDomainFlags_None を指定して ICLRDomainManager::SetAppDomainManagerType を呼び出すことと同じです。
必要条件
プラットフォーム: 「.NET Framework システム要件」を参照
ヘッダー: MetaHost.h
ライブラリ: MSCorEE.dll にリソースとして格納されていること
.NET Framework のバージョン: 4