GetRequestedRuntimeInfo 関数GetRequestedRuntimeInfo Function

アプリケーションによって要求された共通言語ランタイム (CLR) のバージョンとディレクトリ情報を取得します。Gets version and directory information about the common language runtime (CLR) requested by an application.

この関数は、.NET Framework 4 では廃止されました。This function has been deprecated in the .NET Framework 4.

構文Syntax

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  
);  

パラメーターParameters

pExe
[in]アプリケーションの名前。[in] The name of the application.

pwszVersion
[in]ランタイムのバージョン番号を指定する文字列。[in] A string specifying the version number of the runtime.

pConfigurationFile
[in]関連付けられている構成ファイルの名前pExeします。[in] The name of the configuration file that is associated with pExe.

startupFlags
[in]1 つ以上のSTARTUP_FLAGS列挙値。[in] One or more of the STARTUP_FLAGS enumeration values.

runtimeInfoFlags
[in]1 つ以上のRUNTIME_INFO_FLAGS列挙値。[in] One or more of the RUNTIME_INFO_FLAGS enumeration values.

pDirectory
[out]正常完了時にランタイムのディレクトリ パスを格納するバッファー。[out] A buffer that contains the directory path to the runtime upon successful completion.

dwDirectory
[in]ディレクトリのバッファーの長さ。[in] The length of the directory buffer.

dwDirectoryLength
[out]ディレクトリのパス文字列の長さへのポインター。[out] A pointer to the length of the directory path string.

pVersion
[out]正常完了時にランタイムのバージョン番号を格納するバッファー。[out] A buffer that contains the version number of the runtime upon successful completion.

cchBuffer
[in]バージョンの文字列バッファーの長さ。[in] The length of the version string buffer.

dwlength
[out]バージョン文字列の長さへのポインター。[out] A pointer to the length of the version string.

戻り値Return Value

このメソッドは、次の値だけでなく、WinError.h で定義されている標準のコンポーネント オブジェクト モデル (COM) エラー コードを返します。This method returns standard Component Object Model (COM) error codes, as defined in WinError.h, in addition to the following values.

リターン コードReturn code 説明Description
S_OKS_OK メソッドは正常に完了しました。The method completed successfully.
ERROR_INSUFFICIENT_BUFFERERROR_INSUFFICIENT_BUFFER ディレクトリ バッファーは、ディレクトリ パスを格納するのに十分な大きさではありません。The directory buffer is not large enough to store the directory path.

または- or -

バージョン バッファーは、バージョン文字列を格納するのに十分な大きさではありません。The version buffer is not large enough to store the version string.

RemarksRemarks

GetRequestedRuntimeInfoメソッドは必ずしもコンピューターにインストールされている最新バージョンではないと、プロセスに読み込まれたバージョンに関する実行時の情報を返します。The GetRequestedRuntimeInfo method returns run-time information about the version loaded into the process, which is not necessarily the latest version installed on the computer.

.NET Framework version 2.0 を使用している最新のバージョンに関する情報を取得できます、GetRequestedRuntimeInfoメソッドとして、次のとおりです。In the .NET Framework version 2.0, you can get information about the latest installed version by using the GetRequestedRuntimeInfo method as follows:

  • 指定、 pExepwszVersion、およびpConfigurationFileパラメーターを null として。Specify the pExe, pwszVersion, and pConfigurationFile parameters as null.

  • RUNTIME_INFO_UPGRADE_VERSION フラグを指定、RUNTIME_INFO_FLAGSの列挙体、runtimeInfoFlagsパラメーター。Specify the RUNTIME_INFO_UPGRADE_VERSION flag in the RUNTIME_INFO_FLAGS enumerations for the runtimeInfoFlags parameter.

GetRequestedRuntimeInfoメソッドでは、次の状況では、最新の CLR バージョンは返しません。The GetRequestedRuntimeInfo method does not return the latest CLR version in the following circumstances:

  • 特定の CLR バージョンの読み込みを指定するアプリケーション構成ファイルが存在します。An application configuration file that specifies loading a particular CLR version exists. Null を指定した場合でも、.NET Framework は構成ファイルを使用ことに注意してください、pConfigurationFileパラメーター。Note that the .NET Framework will use the configuration file even if you specify null for the pConfigurationFile parameter.

  • CorBindToRuntimeEx CLR の以前のバージョンを指定するメソッドが呼び出されました。The CorBindToRuntimeEx method was called specifying an earlier CLR version.

  • CLR の以前のバージョン用にコンパイルされたアプリケーションは現在実行中です。An application that was compiled for an earlier CLR version is currently running.

runtimeInfoFlagsパラメーターを指定できますアーキテクチャの定数の 1 つだけ、RUNTIME_INFO_FLAGS一度に列挙体。For the runtimeInfoFlags parameter, you can specify only one of the architecture constants of the RUNTIME_INFO_FLAGS enumeration at a time:

  • RUNTIME_INFO_REQUEST_IA64RUNTIME_INFO_REQUEST_IA64

  • RUNTIME_INFO_REQUEST_AMD64RUNTIME_INFO_REQUEST_AMD64

  • RUNTIME_INFO_REQUEST_X86RUNTIME_INFO_REQUEST_X86

必要条件Requirements

プラットフォーム: システム要件に関するページを参照してください。Platforms: See System Requirements.

ヘッダー: MSCorEE.hHeader: MSCorEE.h

ライブラリ: MSCorEE.dllLibrary: MSCorEE.dll

.NET Framework のバージョン: 1.1 以降で使用可能Available since 1.1.NET Framework Versions: 1.1 以降で使用可能Available since 1.1

関連項目See also