GetRequestedRuntimeInfo 函式
更新：2007 年 11 月
取得應用程式所要求關於 Common Language Runtime (CLR) 的版本和目錄資訊。
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] 一或多個 STARTUP_FLAGS 列舉值。runtimeInfoFlags
[in] 一或多個 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 還是會使用組態檔。
呼叫 CorBindToRuntimeEx 方法以指定較舊的 CLR 版本。
針對舊版 CLR 編譯的應用程式正在執行中。
對於 runtimeInfoFlags 參數，每次只能指定 RUNTIME_INFO_FLAGS 列舉型別中的其中一個架構常數：
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