取得應用程式所請求的通用語言執行時(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 [在]申請名稱。
pwszVersion [在]一個字串,指定執行時的版本號。
pConfigurationFile [在]與 相關聯 pExe的設定檔名稱。
startupFlags [在]一個或多個 STARTUP_FLAGS 列舉值。
runtimeInfoFlags [在]一個或多個 RUNTIME_INFO_FLAGS 枚舉值。
pDirectory [出]一個緩衝區,成功完成後會包含通往執行時的目錄路徑。
dwDirectory [在]目錄緩衝區的長度。
dwDirectoryLength [出]一個指向目錄路徑字串長度的指標。
pVersion [出]一個緩衝區,成功完成時會顯示執行時的版本號。
cchBuffer [在]版本字串緩衝區的長度。
dwlength [出]一個指向版本字串長度的指標。
傳回值
此方法會回傳標準的元件物件模型(COM)錯誤碼,依照 WinError.h 定義,並包含以下數值。
| 回傳碼 | Description |
|---|---|
| S_OK | 方法已順利完成。 |
| ERROR_INSUFFICIENT_BUFFER | 目錄緩衝區不夠大,無法儲存目錄路徑。 (或) 版本緩衝區不夠大,無法儲存版本字串。 |
備註
該 GetRequestedRuntimeInfo 方法會回傳載入程序的版本執行時資訊,該版本不一定是電腦上安裝的最新版本。
在 .NET Framework 2.0 版本中,你可以透過以下 GetRequestedRuntimeInfo 方法取得最新安裝版本的資訊:
將 、
pwszVersion和pConfigurationFile參數指定pExe為空。在參數的列舉
runtimeInfoFlags中指定RUNTIME_INFO_UPGRADE_VERSION標誌RUNTIME_INFO_FLAGS。
在以下情況下,該 GetRequestedRuntimeInfo 方法不會回傳最新的 CLR 版本:
有一個應用程式設定檔指定載入特定 CLR 版本。 請注意,即使你在參數中指定為 null
pConfigurationFile,.NET Framework 仍會使用該設定檔。CorBindToRuntimeEx 方法被命名為早期的 CLR 版本。
一個為早期 CLR 版本編譯的應用程式目前正在執行。
對於參數 runtimeInfoFlags ,你一次只能指定列舉的 RUNTIME_INFO_FLAGS 其中一個架構常數:
RUNTIME_INFO_REQUEST_IA64
RUNTIME_INFO_REQUEST_AMD64
RUNTIME_INFO_REQUEST_X86
需求
平台:請參閱系統需求。
標題: MSCorEE.h
圖書館: MSCorEE.dll
.NET Framework 版本: 自 1.1 版本起提供