Funciones de alerta

[Las funciones de alerta no se admiten a partir de Windows Vista porque no se admiten los servicios alerter y messenger.]

Las funciones de alerta de administración de red notifican a los programas de servicio de red y las aplicaciones de eventos de red. Un evento es una instancia determinada de un proceso, una repetición o un estado de hardware según lo definido por una aplicación. Las funciones de alerta permiten a las aplicaciones indicar cuándo se producen eventos predefinidos.

Windows Server 2003: Los servicios de mensajería y alertador están deshabilitados de forma predeterminada en Windows Server 2003. Debe volver a habilitar los servicios antes de llamar a las funciones de alerta de administración de red o a las funciones de mensaje de administración de red.

Las funciones de alerta se enumeran a continuación.

Función	Descripción
NetAlertRaise	Notifica a todos los clientes registrados que se ha producido un evento determinado.
NetAlertRaiseEx	Simplifica la notificación a los clientes registrados de que se ha producido un evento determinado, ya que, a diferencia de NetAlertRaise, NetAlertRaiseEx no requiere una estructura de STD_ALERT .

 

El servicio de alertas debe ejecutarse en el equipo cliente cuando se llama a la función NetAlertRaise o a la función NetAlertRaiseEx . Si el servicio no se está ejecutando, se producirá un error en las funciones con ERROR_FILE_NOT_FOUND. El servicio alerter del cliente llama a la función NetMessageBufferSend para enviar información a los destinatarios.

Las aplicaciones, los servicios de red y los componentes de red internos usan las funciones de alerta de administración de red para generar una alerta, notificando a varias aplicaciones o usuarios cuando se produce un tipo determinado de evento. Las funciones de categoría de alerta, los tipos de datos, las estructuras y las constantes se definen en LMCONS. H, LMERR. H, y LMALERT. Archivos de encabezado H. Para acceder a estas definiciones, defina las constantes INCL_NETERRORS y INCL_NETALERT, e incluya el archivo de encabezado LM.H.

The LMALERT. El archivo H predefine las siguientes clases de alerta (tipos de eventos de red) para enviar alertas:

• Eventos de red que requieren asistencia administrativa
• Adición de una entrada a un archivo de registro de errores
• Recepción de un mensaje de difusión por parte de un usuario o una aplicación
• Finalización de un trabajo de impresión
• Uso de determinadas aplicaciones o recursos por parte de los usuarios

Puede definir otras clases de alertas para las aplicaciones de red según sea necesario. Por ejemplo, si una aplicación de un servidor escribe rutinariamente grandes cantidades de datos en una unidad de disco, la aplicación corre el riesgo de rellenar el disco. En este caso, es posible que desee agregar el evento "sin espacio libre en disco" para desencadenar una alerta que notifique a la aplicación que detenga o finalice el proceso que está rellenando el disco. El nombre del evento de una alerta puede ser cualquier cadena de texto.

Cuando se genera una alerta con una llamada a la función NetAlertRaise, los datos del mensaje deben constar de una estructura de encabezado STD_ALERT, seguida de datos de longitud fija adicionales que son específicos de alertas en una ADMIN_OTHER_INFO, ERRLOG_OTHER_INFO, PRINT_OTHER_INFO o estructura de USER_OTHER_INFO. Los datos adicionales de longitud variable pueden seguir la estructura específica de la alerta. (Las llamadas a la función NetAlertRaiseEx no requieren una estructura STD_ALERT ). La aplicación que realiza la llamada debe asignar la memoria para todas las estructuras y datos de longitud variable, y liberar la memoria después de que se devuelva la llamada.

Las macros siguientes están disponibles para su uso con búferes de datos de alertas.

Macro	Descripción
ALERT_OTHER_INFO	Devuelve un puntero a los datos de longitud fija que siguen a la estructura STD_ALERT en un mensaje de alerta.
ALERT_VAR_DATA	Devuelve un puntero a los datos de longitud variable que siguen los datos específicos de la alerta en un mensaje de alerta.

 

En lugar de usar las funciones de alerta de administración de red, es posible que pueda usar el SDK de Instrumental de administración de Windows (WMI) para la notificación de eventos. Para obtener más información sobre las plataformas que admiten el modelo de eventos WMI, consulte Eventos de supervisión e infraestructura de WMI en la documentación de WMI.