estructura SERVICE_NOTIFY_2A (winsvc.h)

  • Artículo

Representa la información de notificación de estado del servicio. Lo usa la función NotifyServiceStatusChange .

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 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 es 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 está ERROR_SUCCESS y la notificación se 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 poder 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 neutro de codificación con código que no es neutral de codificación puede provocar discrepancias que dan lugar a errores de compilación o en 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

NotifyServiceStatusChange

SERVICE_STATUS_PROCESS