次の方法で共有

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) エラー コードを返します。

リターン コード Description
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 では構成ファイルが使用されることに注意してください。

  • CorBindToRuntimeEx メソッドは、以前の CLR バージョンを指定して呼び出されました。

  • 以前の CLR バージョン用にコンパイルされたアプリケーションが現在実行中です。

runtimeInfoFlags パラメーターでは、RUNTIME_INFO_FLAGS列挙体のアーキテクチャ定数を一度に 1 つだけ指定できます。

  • RUNTIME_INFO_REQUEST_IA64

  • RUNTIME_INFO_REQUEST_AMD64

  • RUNTIME_INFO_REQUEST_X86

Requirements

:「システム要件」を参照してください。

ヘッダ： MSCorEE.h

ライブラリ: MSCorEE.dll

.NET Framework のバージョン: 1.1 以降で利用可能

こちらも参照ください

  • Last updated on