estructura SERVICE_FAILURE_ACTIONSA (winsvc.h)

Representa la acción que el controlador de servicio debe realizar en cada error de un servicio. Un servicio se considera erróneo cuando finaliza sin notificar un estado de SERVICE_STOPPED al controlador de servicio.

Para configurar circunstancias adicionales en las que se van a ejecutar las acciones de error, consulte SERVICE_FAILURE_ACTIONS_FLAG.

Sintaxis

typedef struct _SERVICE_FAILURE_ACTIONSA {
  DWORD     dwResetPeriod;
  LPSTR     lpRebootMsg;
  LPSTR     lpCommand;
  DWORD     cActions;
  SC_ACTION *lpsaActions;
} SERVICE_FAILURE_ACTIONSA, *LPSERVICE_FAILURE_ACTIONSA;

Miembros

dwResetPeriod

Tiempo después del cual se restablece el recuento de errores en cero si no hay errores, en segundos. Especifique INFINITE para indicar que este valor nunca se debe restablecer.

lpRebootMsg

Mensaje que se va a difundir a los usuarios del servidor antes de reiniciar en respuesta a la acción de controlador de servicio SC_ACTION_REBOOT .

Si este valor es NULL, el mensaje de reinicio no cambia. Si el valor es una cadena vacía (""), se elimina el mensaje de reinicio y no se difunde ningún mensaje.

Este miembro puede especificar una cadena localizada con el formato siguiente:

@[path]dllname,-strID

La cadena con identificador strID se carga desde dllname; la ruta de acceso es opcional. Para obtener más información, vea RegLoadMUIString.

Windows Server 2003 y Windows XP: Las cadenas localizadas no se admiten hasta Windows Vista.

lpCommand

Línea de comandos del proceso para que la función CreateProcess se ejecute en respuesta a la acción de controlador de servicio SC_ACTION_RUN_COMMAND. Este proceso se ejecuta en la misma cuenta que el servicio.

Si este valor es NULL, el comando no cambia. Si el valor es una cadena vacía (""), el comando se elimina y no se ejecuta ningún programa cuando se produce un error en el servicio.

cActions

Número de elementos de la matriz lpsaActions .

Si este valor es 0, pero lpsaActions no es NULL, se eliminan el período de restablecimiento y la matriz de acciones de error.

lpsaActions

Puntero a una matriz de estructuras de SC_ACTION .

Si este valor es NULL, se omiten los miembros cActions y dwResetPeriod .

Comentarios

El administrador de control de servicio cuenta el número de veces que se ha producido un error en cada servicio desde el arranque del sistema. El recuento se restablece a 0 si no se ha producido un error en el servicio durante los segundos dwResetPeriod . Cuando se produce un error en el serviciopor primera vez, el controlador de servicio realiza la acción especificada en el elemento [N-1] de la matriz lpsaActions . Si N es mayor que cActions, el controlador de servicio repite la última acción de la matriz.

Nota

El encabezado winsvc.h define SERVICE_FAILURE_ACTIONS como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Convenciones para prototipos de función.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Encabezado	winsvc.h (incluye Windows.h)

Consulte también

ChangeServiceConfig2

CreateProcess

QueryServiceConfig2

SC_ACTION

SERVICE_FAILURE_ACTIONS_FLAG