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 ejecutarán 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 debe restablecerse.
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 de 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 emite ningún mensaje.
Este miembro puede especificar una cadena localizada con el siguiente formato:
@[ruta de acceso]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: no se admiten cadenas localizadas hasta Windows Vista.
lpCommand
Línea de comandos del proceso para que la función CreateProcess de
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 de 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, los miembros de cActions y dwResetPeriod se omiten.
Observaciones
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 dwResetPeriod segundos. Cuando se produce un error en el servicio para la Nésima vez, el controlador de servicio realiza la acción especificada en el elemento [N-1] de la matriz de 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 Conventions for Function Prototypes.
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Windows XP [solo aplicaciones de escritorio] |
| servidor mínimo admitido | Windows Server 2003 [solo aplicaciones de escritorio] |
| encabezado de |
winsvc.h (incluya Windows.h) |
Consulte también