Class Winsvc.SERVICE_FAILURE_ACTIONS

  • Direct Known Subclasses:
    Winsvc.SERVICE_FAILURE_ACTIONS.ByReference
    Enclosing interface:
    Winsvc

    @FieldOrder({"dwResetPeriod","lpRebootMsg","lpCommand","cActions","lpsaActions"})
    public static class Winsvc.SERVICE_FAILURE_ACTIONS
    extends Winsvc.ChangeServiceConfig2Info
    Represents the action the service controller should take on each failure of a service. A service is considered failed when it terminates without reporting a status of SERVICE_STOPPED to the service controller. To configure additional circumstances under which the failure actions are to be executed, see SERVICE_FAILURE_ACTIONS_FLAG.
    • Field Detail

      • dwResetPeriod

        public int dwResetPeriod
        The time after which to reset the failure count to zero if there are no failures, in seconds. Specify INFINITE to indicate that this value should never be reset.
      • lpRebootMsg

        public String lpRebootMsg
        The message to be broadcast to server users before rebooting in response to the SC_ACTION_REBOOT service controller action. If this value is NULL, the reboot message is unchanged. If the value is an empty string (""), the reboot message is deleted and no message is broadcast. This member can specify a localized string using the following format: "@[path]dllname,-strID" The string with identifier strID is loaded from dllname; the path is optional. For more information, see RegLoadMUIString. Windows Server 2003 and Windows XP: Localized strings are not supported until Windows Vista.
      • lpCommand

        public String lpCommand
        The command line of the process for the CreateProcess function to execute in response to the SC_ACTION_RUN_COMMAND service controller action. This process runs under the same account as the service. If this value is NULL, the command is unchanged. If the value is an empty string (""), the command is deleted and no program is run when the service fails.
      • cActions

        public int cActions
        The number of elements in the lpsaActions array. If this value is 0, but lpsaActions is not NULL, the reset period and array of failure actions are deleted.
      • lpsaActions

        public Winsvc.SC_ACTION.ByReference lpsaActions
        A pointer to an array of SC_ACTION structures. If this value is NULL, the cActions and dwResetPeriod members are ignored.
    • Constructor Detail

      • SERVICE_FAILURE_ACTIONS

        public SERVICE_FAILURE_ACTIONS()
      • SERVICE_FAILURE_ACTIONS

        public SERVICE_FAILURE_ACTIONS​(Pointer p)