estructura SERVICE_NOTIFY_2A (winsvc.h)
Representa la información de notificación de estado del servicio. Lo usa la función
Sintaxis
typedef struct _SERVICE_NOTIFY_2A {
DWORD dwVersion;
PFN_SC_NOTIFY_CALLBACK pfnNotifyCallback;
PVOID pContext;
DWORD dwNotificationStatus;
SERVICE_STATUS_PROCESS ServiceStatus;
DWORD dwNotificationTriggered;
LPSTR pszServiceNames;
} SERVICE_NOTIFY_2A, *PSERVICE_NOTIFY_2A;
Miembros
dwVersion
Versión de la estructura. Este miembro debe ser SERVICE_NOTIFY_STATUS_CHANGE (2).
pfnNotifyCallback
Puntero a la función de devolución de llamada. Para obtener más información, vea Comentarios.
pContext
Cualquier dato definido por el usuario que se va a pasar a la función de devolución de llamada.
dwNotificationStatus
Valor que indica el estado de la notificación. Si este miembro es ERROR_SUCCESS, la notificación se ha realizado correctamente y el miembro de ServiceStatus contiene información válida. Si este miembro es ERROR_SERVICE_MARKED_FOR_DELETE, el servicio se ha marcado para su eliminación y el identificador de servicio usado por NotifyServiceStatusChange debe cerrarse.
ServiceStatus
Estructura SERVICE_STATUS_PROCESS que contiene la información de estado del servicio. Este miembro solo es válido si dwNotificationStatus es ERROR_SUCCESS.
dwNotificationTriggered
Si dwNotificationStatus es ERROR_SUCCESS, este miembro contiene una máscara de bits de las notificaciones que desencadenó esta llamada a la función de devolución de llamada.
pszServiceNames
Si dwNotificationStatus es ERROR_SUCCESS y la notificación es SERVICE_NOTIFY_CREATED o SERVICE_NOTIFY_DELETED, este miembro es válido y es una cadena de MULTI_SZ que contiene uno o varios nombres de servicio. Los nombres de los servicios creados tendrán un prefijo "/" para que pueda distinguirlos de los nombres de los servicios eliminados.
Si este miembro es válido, la función de devolución de llamada de notificación debe liberar la cadena mediante la función LocalFree.
Observaciones
La función de devolución de llamada se declara de la siguiente manera:
typedef VOID( CALLBACK * PFN_SC_NOTIFY_CALLBACK ) (
IN PVOID pParameter
);
La función de devolución de llamada recibe un puntero a la estructura SERVICE_NOTIFY proporcionada por el autor de la llamada.
Nota
El encabezado winsvc.h define SERVICE_NOTIFY_2 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 Vista [solo aplicaciones de escritorio] |
| servidor mínimo admitido | Windows Server 2008 [solo aplicaciones de escritorio] |
| encabezado de |
winsvc.h (incluya Windows.h) |