GetRequestedRuntimeInfo 関数
アプリケーションによって要求された共通言語ランタイム (CLR) についてのバージョン情報とディレクトリ情報を取得します。
この関数は、.NET Framework 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
[in] アプリケーションの名前。
pwszVersion
[in] ランタイムのバージョン番号を指定する文字列。
pConfigurationFile
[in] pExe に関連付けられている構成ファイルの名前。
startupFlags
[in] 1 つ以上の STARTUP_FLAGS 列挙値。
runtimeInfoFlags
[in] 1 つ以上の RUNTIME_INFO_FLAGS 列挙値。
pDirectory
[out] 正常に完了したときのランタイムへのディレクトリ パスを格納するバッファー。
dwDirectory
[in] ディレクトリ バッファーの長さ。
dwDirectoryLength
[out] ディレクトリ パス文字列の長さへのポインター。
pVersion
[out] 正常に完了したときのランタイムへのバージョン番号を格納するバッファー。
cchBuffer
[in] バージョン文字列バッファーの長さ。
dwlength
[out] バージョン文字列の長さへのポインター。
戻り値
このメソッドでは、WinError.h で定義されているように、次の値に加えて標準のコンポーネント オブジェクト モデル (COM) エラー コードが返されます。
| リターン コード | 説明 |
|---|---|
| S_OK | メソッドは正常に完了しました。 |
| ERROR_INSUFFICIENT_BUFFER | ディレクトリ バッファーが、ディレクトリ パスを格納するのに十分な大きさではありません。 または ディレクトリ バッファーが、バージョン文字列を格納するのに十分な大きさではありません。 |
解説
GetRequestedRuntimeInfo メソッドから、プロセスに読み込まれたバージョンに関するランタイム情報が返されます。これは、必ずしもコンピューターにインストールされている最新バージョンではありません。
.NET Framework バージョン 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
必要条件
:「システム要件」を参照してください。
ヘッダー: MSCorEE.h
ライブラリ: MSCorEE.dll
.NET Framework のバージョン: 1.1 以降で使用可能
関連項目
.NET