setupPromptReboot 函数 (setupapi.h)

[此函数可用于“要求”部分所示的操作系统。它可能在后续版本中变更或不可用。不应再使用 SetupAPI 来安装应用程序。请改用 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。