METAHOST_POLICY_FLAGS 列挙体
ほとんどのランタイム ホストに共通のバインディング ポリシーを提供します。 この列挙体は、ICLRMetaHostPolicy::GetRequestedRuntime メソッドによって使用されます。
構文
typedef enum {
METAHOST_POLICY_HIGHCOMPAT = 0x00,
METAHOST_POLICY_APPLY_UPGRADE_POLICY = 0x08,
METAHOST_POLICY_EMULATE_EXE_LAUNCH = 0x10,
METAHOST_POLICY_SHOW_ERROR_DIALOG = 0x20,
METAHOST_POLICY_USE_PROCESS_IMAGE_PATH = 0x40,
METAHOST_POLICY_ENSURE_SKU_SUPPORTED = 0x80,
METAHOST_POLICY_IGNORE_ERROR_MODE = 0x1000
} METAHOST_POLICY_FLAGS;
メンバー
メンバー | 説明 |
---|---|
METAHOST_POLICY_HIGHCOMPAT |
現在のプロセスに読み込まれる共通言語ランタイム (CLR) を考慮しない、互換性の高いポリシーを定義します。 代わりに、インストールされた CLR と、アセンブリファイル自体、宣言された組み込みバージョン、または構成ファイルから派生するコンポーネントの設定のみを考慮します。 |
METAHOST_POLICY_APPLY_UPGRADE_POLICY |
HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\.NETFramework\Policy\Upgrades の内容に基づいて完全一致が見つからなかった場合に、バージョンのバインド結果にアップグレード ポリシーを適用します。 これは、RUNTIME_INFO_UPGRADE_VERSION を実行するのと同じ効果があります。 |
METAHOST_POLICY_EMULATE_EXE_LAUNCH |
呼び出しに対して指定されたイメージが新しいプロセスで起動されたかのように、バインディングの結果が返されます。 現在、GetRequestedRuntime では一連の読み込み可能なランタイムが無視され、インストールされている一連のランタイムがバインドされます。 このフラグにより、ホストは起動時に EXE がバインドされるランタイムを決定できます。 |
METAHOST_POLICY_SHOW_ERROR_DIALOG |
GetRequestedRuntime により入力パラメーターと互換性のあるランタイムが見つからない場合、エラーダイアログ ボックスが表示されます。 .NET Framework 4.5 以降、このエラー ダイアログ ボックスには、ユーザーが適切な機能を有効にするかどうかを確認する Windows の機能ダイアログ ボックスが表示されます。 |
METAHOST_POLICY_USE_PROCESS_IMAGE_PATH |
GetRequestedRuntime では、プロセス イメージ (およびそれに対応するすべての構成ファイル) がバインド プロセスへの追加入力として使用されます。 既定では、バインド先のランタイムを決定するときに、GetRequestedRuntime はプロセス イメージ パス (通常はプロセスの起動に使用された EXE) にフォール バックしません。 |
METAHOST_POLICY_ENSURE_SKU_SUPPORTED |
構成ファイルに利用できる情報がない場合、GetRequestedRuntime による適切な SKU がインストールされているかどうかの確認が必要です。 これにより、構成ファイルを持たないアプリケーションで、.NET Framework の既定のインストールよりも小さい SKU で適切な形での失敗が可能になります。 既定では、構成ファイル <supportedRuntime /> 要素で SKU 属性が指定されていない限り、GetRequestedRuntime により適切な SKU がインストールされているかどうかが確認されません。 |
METAHOST_POLICY_IGNORE_ERROR_MODE |
GetRequestedRuntime では、SEM_FAILCRITICALERRORS (SetErrorMode 関数の呼び出しによって設定される) が無視され、エラー ダイアログ ボックスが表示されます。 既定では、SEM_FAILCRITICALERRORS によりエラー ダイアログ ボックスは表示されません。 このファイルは別のプロセスから継承されている可能性があり、シナリオによってはサイレント エラーが望ましくない場合があります。 |
解説
必要条件
:「システム要件」を参照してください。
ヘッダー: Metahost.h
ライブラリ: MSCorEE.dll にリソースとして含まれます
.NET Framework のバージョン: 4 以降で使用可能
関連項目
GitHub で Microsoft と共同作業する
このコンテンツのソースは GitHub にあります。そこで、issue や pull request を作成および確認することもできます。 詳細については、共同作成者ガイドを参照してください。
.NET