更新 : 2007 年 11 月
アプリケーションが要求した共通言語ランタイム (CLR: Common Language Runtime) についてのバージョン情報とディレクトリ情報を取得します。
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.idl
ライブラリ : MSCorEE.dll
.NET Framework のバージョン : 3.5 SP1、3.5、3.0 SP1、3.0、2.0 SP1、2.0、1.1