Función NotifyBootConfigStatus (winsvc.h)
Notifica el estado de arranque al administrador de controles de servicio. Lo usan los programas de verificación de arranque. Solo un proceso que se ejecuta en la cuenta de LocalSystem o administrador puede llamar a esta función.
Sintaxis
BOOL NotifyBootConfigStatus(
[in] BOOL BootAcceptable
);
Parámetros
[in] BootAcceptable
Si el valor es TRUE, el sistema guarda la configuración como la última configuración correcta conocida. Si el valor es FALSE, el sistema se reinicia inmediatamente mediante la última configuración correcta guardada anteriormente.
Valor devuelto
Si el parámetro BootAcceptable es FALSE, la función no devuelve.
Si la última configuración correcta conocida se guardó correctamente, el valor devuelto es distinto de cero.
Si se produce un error, el valor devuelto es cero. Para obtener información de error extendida, llame a GetLastError.
El administrador de control de servicios puede establecer los siguientes códigos de error. Otros códigos de error pueden establecerse mediante las funciones del Registro a las que llama el administrador de controles de servicio para establecer parámetros en el Registro de configuración.
| Código devuelto | Descripción |
|---|---|
|
El usuario no tiene permiso para realizar esta operación. Solo el sistema y los miembros del grupo del administrador pueden hacerlo. |
Comentarios
Guardar la configuración de un sistema en ejecución con esta función es un método aceptable para guardar la última configuración correcta conocida. Si la configuración de arranque es inaceptable, use esta función para reiniciar el sistema mediante la última configuración correcta conocida existente.
Esta llamada de función requiere que el token del autor de la llamada tenga permiso para adquirir el derecho de acceso SC_MANAGER_MODIFY_BOOT_CONFIG. Para obtener más información, consulte Derechos de acceso y seguridad de servicio.
Requisitos
| 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 | winsvc.h (incluye Windows.h) |
| Library | Advapi32.lib |
| Archivo DLL | Advapi32.dll |