Функция SetupPromptReboot (setupapi.h)
[Эта функция доступна для использования в операционных системах, указанных в разделе Требования. В последующих версиях он может быть изменен или недоступен. SetupAPI больше не следует использовать для установки приложений. Вместо этого используйте установщик Windows для разработки установщиков приложений. 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.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows XP [только классические приложения] |
| Минимальная версия сервера | Windows Server 2003 [только классические приложения] |
| Целевая платформа | Windows |
| Header | setupapi.h |
| Библиотека | Setupapi.lib |
| DLL | Setupapi.dll |