Función NotifyBootConfigStatus (winsvc.h)

  • Artículo

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
ERROR_ACCESS_DENIED
 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

Consulte también

Inicio automático de servicios

Funciones de servicio