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 以降で使用可能

関連項目