NOTIFICATION
Hace referencia a: Outlook 2013 | Outlook 2016
Contiene información sobre un evento que se ha producido y los datos que se han visto afectados por el evento.
| Propiedad | Valor |
|---|---|
| Archivo de encabezado: |
Mapidefs.h |
typedef struct
{
ULONG ulEventType;
union
{
ERROR_NOTIFICATION err;
NEWMAIL_NOTIFICATION newmail;
OBJECT_NOTIFICATION obj;
TABLE_NOTIFICATION tab;
EXTENDED_NOTIFICATION ext;
STATUS_OBJECT_NOTIFICATION statobj;
} info;
} NOTIFICATION, FAR *LPNOTIFICATION;
Members
ulEventType
Tipo de evento de notificación que se produjo. El valor del miembro ulEventType corresponde a la estructura que se incluye en la unión de información . El miembro ulEventType se puede establecer en uno de los siguientes valores:
fnevCriticalError
Se ha producido un error global, como un cierre de sesión en curso. El miembro de información contiene una estructura de ERROR_NOTIFICATION .
fnevExtended
Se ha producido un evento interno definido por un proveedor de servicios determinado. El miembro de información contiene una estructura EXTENDED_NOTIFICATION .
fnevNewMail
Se ha entregado un mensaje a la carpeta de recepción adecuada para la clase de mensaje y está esperando a que se procese. El miembro de información contiene una estructura NEWMAIL_NOTIFICATION .
fnevObjectCopied
Se ha copiado un objeto MAPI. El miembro de información contiene una estructura OBJECT_NOTIFICATION .
fnevObjectCreated
Se ha creado un objeto MAPI. El miembro de información contiene una estructura OBJECT_NOTIFICATION .
fnevObjectDeleted
Se ha eliminado un objeto MAPI. El miembro de información contiene una estructura OBJECT_NOTIFICATION .
fnevObjectModified
Un objeto MAPI ha cambiado. El miembro de información contiene una estructura OBJECT_NOTIFICATION .
fnevObjectMoved
Se ha movido un almacén de mensajes o un objeto de libreta de direcciones. El miembro de información contiene una estructura OBJECT_NOTIFICATION .
fnevSearchComplete
Una operación de búsqueda ha finalizado y los resultados están disponibles. El miembro de información contiene una estructura OBJECT_NOTIFICATION .
fnevTableModified
La información de una tabla ha cambiado. El miembro de información contiene una estructura de TABLE_NOTIFICATION .
info
Unión de estructuras de notificación que describen los datos afectados para un tipo determinado de evento. La estructura incluida en el miembro de información depende del valor del miembro ulEventType .
Comentarios
Una o varias estructuras NOTIFICATION se pasan como parámetros de entrada con cada llamada al método IMAPIAdviseSink::OnNotify de un receptor de aviso registrado. Las estructuras NOTIFICATION contienen información sobre los eventos concretos que se han producido y describen los objetos afectados.
Antes de que los clientes o proveedores de servicios que reciben una notificación puedan usar la estructura para procesar el evento, deben comprobar el tipo de evento como se indica en el miembro ulEventType . Por ejemplo, el ejemplo de código que se muestra aquí comprueba la llegada de un mensaje nuevo y, al detectar un evento de este tipo, imprime la clase de mensaje del mensaje.
if (pNotif -> ulEventType == fnevNewMail)
{
printf("%s\n", pNotif -> newmail.lpszMessageClass)
}
Para obtener más información sobre la notificación, consulte los temas descritos en la tabla siguiente.
| Tema | Descripción |
|---|---|
|
Notificación de eventos en MAPI |
Introducción general a los eventos de notificación y notificación. |
|
Control de notificaciones |
Explicación de cómo los clientes deben controlar las notificaciones. |
|
Notificación de eventos auxiliar |
Explicación de cómo los proveedores de servicios pueden usar el método IMAPISupport para generar notificaciones. |