Función SetupPromptReboot (setupapi.h)
[Esta función está disponible para su uso en los sistemas operativos indicados en la sección Requisitos. En versiones posteriores podría modificarse o no estar disponible. SetupAPI ya no debe usarse para instalar aplicaciones. En su lugar, use Windows Installer para desarrollar instaladores de aplicaciones. SetupAPI sigue utilizándose para instalar controladores de dispositivo.
La función SetupPromptReboot pregunta al usuario si quiere reiniciar el sistema, opcionalmente depende de si algún archivo de una cola de archivos confirmada estaba en uso durante una operación de archivo. Si el usuario responde "sí" al símbolo del sistema, se inicia el apagado antes de que vuelva esta rutina.
Sintaxis
WINSETUPAPI INT SetupPromptReboot(
[in] HSPFILEQ FileQueue,
[in] HWND Owner,
[in] BOOL ScanOnly
);
Parámetros
[in] FileQueue
Puntero opcional a un identificador de la cola de archivos en la que basar la decisión sobre si el apagado es necesario. Si no se especifica FileQueue , SetupPromptReboot supone que el apagado es necesario y pregunta al usuario qué hacer.
[in] Owner
Identificador de la ventana primaria para que posea ventanas creadas por esta función.
[in] ScanOnly
Indica si se va a preguntar al usuario cuando se llama a SetupPromptReboot .
Si es TRUE, el usuario nunca se pregunta sobre el reinicio y no se inicia el apagado del sistema. En este caso, se debe especificar FileQueue . Si es FALSE, se le pregunta al usuario sobre el reinicio, como se ha descrito anteriormente.
Use ScanOnly para determinar si el apagado es necesario por separado de iniciar realmente un apagado.
Valor devuelto
La función devuelve una combinación de las marcas siguientes o –1 si se produce un error.
Para obtener información de error extendida, llame a GetLastError.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows XP [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2003 [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | setupapi.h |
| Library | Setupapi.lib |
| Archivo DLL | Setupapi.dll |