SERVICE_NOTIFY_2W estructura (winsvc.h)
Representa la información de notificación de estado del servicio. La función NotifyServiceStatusChange la usa.
Sintaxis
typedef struct _SERVICE_NOTIFY_2W {
DWORD dwVersion;
PFN_SC_NOTIFY_CALLBACK pfnNotifyCallback;
PVOID pContext;
DWORD dwNotificationStatus;
SERVICE_STATUS_PROCESS ServiceStatus;
DWORD dwNotificationTriggered;
LPWSTR pszServiceNames;
} SERVICE_NOTIFY_2W, *PSERVICE_NOTIFY_2W;
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 la sección Comentarios.
pContext
Los datos definidos por el usuario que se van 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 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 está ERROR_SUCCESS.
dwNotificationTriggered
Si dwNotificationStatus está ERROR_SUCCESS, este miembro contiene una máscara de bits de las notificaciones que desencadenaron esta llamada a la función de devolución de llamada.
pszServiceNames
Si dwNotificationStatus es ERROR_SUCCESS y la notificación se SERVICE_NOTIFY_CREATED o SERVICE_NOTIFY_DELETED, este miembro es válido y es una cadena 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 .
Comentarios
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 Convenciones para prototipos de función.
Requisitos
Requisito | Value |
---|---|
Cliente mínimo compatible | Windows Vista [solo aplicaciones de escritorio] |
Servidor mínimo compatible | Windows Server 2008 [solo aplicaciones de escritorio] |
Encabezado | winsvc.h (incluye Windows.h) |
Consulte también
Comentarios
https://aka.ms/ContentUserFeedback.
Próximamente: a lo largo de 2024, eliminaremos gradualmente los problemas de GitHub como mecanismo de comentarios para el contenido y lo reemplazaremos por un nuevo sistema de comentarios. Para obtener más información, consulte:Enviar y ver comentarios de