SetupPromptReboot 函式 (setupapi.h)

[此函式可用於需求一節中所述的操作系統。它在後續版本中可能會變更或無法使用。安裝程式API不應再用於安裝應用程式。請改用 Windows Installer 來開發應用程式安裝程式。 SetupAPI 會繼續用於安裝設備驅動器。]

SetupPromptReboot 函式會詢問使用者是否要重新啟動系統，選擇性地取決於認可檔案佇列中是否有任何檔案在檔案作業期間正在使用。如果使用者對提示回答「是」，則會在此例程傳回之前起始關機。

語法

WINSETUPAPI INT SetupPromptReboot(
  [in] HSPFILEQ FileQueue,
  [in] HWND     Owner,
  [in] BOOL     ScanOnly
);

[in] FileQueue

檔案佇列句柄的選擇性指標，以決定是否需要關機。如果未指定 FileQueue，SetupPromptReboot 會假設需要關機，並詢問使用者該怎麼做。

[in] Owner

父視窗的句柄，以擁有此函式所建立的視窗。

[in] ScanOnly

指出是否要在呼叫 SetupPromptReboot 時提示使用者。

如果 為 TRUE，則永遠不會詢問使用者重新啟動，而且系統關機不會起始。在此情況下，必須指定 FileQueue 。如果為 FALSE，系統會詢問使用者重新啟動，如先前所述。

使用 ScanOnly 來判斷是否需要個別關機，而不需要實際起始關機。

如果發生錯誤，此函式會傳回下列旗標或 –1 的組合。

若要取得擴充的錯誤資訊，請呼叫 GetLastError。