Función SetupPromptReboot (setupapi.h)

Artículo
03/13/2024

[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

Vea también

Funciones

Información general

SetupPromptForDisk

Share via