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] 一或多個 STARTUP_FLAGS 列舉值。
runtimeInfoFlags
[in] 一或多個 RUNTIME_INFO_FLAGS 列舉值。
pDirectory
[out] 緩衝區,包含在成功完成時執行階段的目錄路徑。
dwDirectory
[in] 目錄緩衝區長度。
dwDirectoryLength
[out] 目錄路徑字串長度指標。
pVersion
[out] 緩衝區,包含在成功完成時執行階段的版本號碼。
cchBuffer
[in] 版本字串緩衝區長度。
dwlength
[out] 版本字串長度指標。
傳回值
除了下列值之外,此方法會傳回標準元件物件模型 (COM) 錯誤碼,如 WinError.h 所定義。
傳回碼 | 描述 |
---|---|
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 版本。 請注意,即使您為 參數指定 null,.NET Framework仍會使用組
pConfigurationFile
態檔。已呼叫 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 起可用