共用方式為


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 [在]申請名稱。

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 方法取得最新安裝版本的資訊:

  • 將 、 pwszVersionpConfigurationFile 參數指定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 版本起提供

另請參閱