GetRequestedRuntimeInfo 関数
アプリケーションが要求した共通言語ランタイム (CLR: Common Language Runtime) についてのバージョン情報とディレクトリ情報を取得します。
この関数は、.NET Framework Version 4 では推奨されていません。
HRESULT GetRequestedRuntimeInfo (
[in] LPCWSTR pExe,
[in] LPCWSTR pwszVersion,
[in] LPCWSTR pConfigurationFile,
[in] DWORD startupFlags,
[in] DWORD runtimeInfoFlags,
[out] LPWSTR pDirectory,
[in] DWORD dwDirectory,
[out] DWORD *dwDirectoryLength,
[out] LPWSTR pVersion,
[in] DWORD cchBuffer,
[out] DWORD *dwlength
);
パラメーター
pExe
[入力] アプリケーションの名前。pwszVersion
[入力] ランタイムのバージョン番号を指定する文字列。pConfigurationFile
[入力] pExe に関連付けられた構成ファイルの名前。startupFlags
[入力] 1 つまたは複数の STARTUP_FLAGS 列挙値。runtimeInfoFlags
[入力] 1 つまたは複数の RUNTIME_INFO_FLAGS 列挙値。pDirectory
[出力] 正常に完了した場合にランタイムへのディレクトリ パスが格納されるバッファー。dwDirectory
[入力] ディレクトリ バッファーの長さ。dwDirectoryLength
[出力] ディレクトリ パス文字列の長さへのポインター。pVersion
[出力] 正常に完了した場合にランタイムのバージョン番号が格納されるバッファー。cchBuffer
[入力] バージョン文字列バッファーの長さ。dwlength
[出力] バージョン文字列の長さへのポインター。
戻り値
このメソッドは、WinError.h で定義された標準のコンポーネント オブジェクト モデル (COM: Component Object Model) エラー コードの他、次の値も返します。
リターン コード |
説明 |
|---|---|
S_OK |
メソッドは正常に終了しました。 |
ERROR_INSUFFICIENT_BUFFER |
ディレクトリ バッファーの大きさが足りないため、ディレクトリ パスを格納できません。 または バージョン バッファーの大きさが足りないため、バージョン文字列を格納できません。 |
解説
GetRequestedRuntimeInfo メソッドは、プロセスに読み込まれたバージョンに関するランタイム情報を返します。これは、必ずしもコンピューターにインストールされている最新バージョンではありません。
.NET Framework Version 2.0 では、次のように GetRequestedRuntimeInfo メソッドを使用することで、インストールされている最新バージョンに関する情報を取得できます。
pExe、pwszVersion、および pConfigurationFile パラメーターを null として指定します。
runtimeInfoFlags パラメーターの RUNTIME_INFO_FLAGS 列挙体で RUNTIME_INFO_UPGRADE_VERSION フラグを指定します。
次のような場合、GetRequestedRuntimeInfo メソッドは最新の CLR バージョンを返しません。
特定の CLR バージョンの読み取りを指定するアプリケーション構成ファイルが存在する。 pConfigurationFile パラメーターに null を指定した場合でも、.NET Framework は構成ファイルを使用することに注意してください。
以前の CLR バージョンを指定する CorBindToRuntimeEx メソッドが呼び出された。
以前のバージョンの CLR 向けにコンパイルされたアプリケーションが現在実行されている。
runtimeInfoFlags パラメーターの場合、一度に指定できる RUNTIME_INFO_FLAGS 列挙型のアーキテクチャ定数は 1 つのみです。
RUNTIME_INFO_REQUEST_IA64
RUNTIME_INFO_REQUEST_AMD64
RUNTIME_INFO_REQUEST_X86
必要条件
プラットフォーム: 「.NET Framework システム要件」を参照
ヘッダー : MSCorEE.h
ライブラリ: MSCorEE.dll
.NET Framework のバージョン: 4、3.5 SP1、3.5、3.0 SP1、3.0、2.0 SP1、2.0、1.1