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

関連項目