共用方式為


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 的相關資訊,如下所示:

  • 指定 pExepwszVersionpConfigurationFile 參數為 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 起可用

另請參閱