NOTIFCALLBACK
Hace referencia a: Outlook 2013 | Outlook 2016
Define una función de devolución de llamada a la que MAPI llama para enviar una notificación de evento. Esta función de devolución de llamada solo se puede usar cuando se encapsula en un objeto receptor de aviso creado mediante una llamada a la función HrAllocAdviseSink .
| Propiedad | Valor |
|---|---|
| Archivo de encabezado: |
Mapidefs.h |
| Función definida implementada por: |
Aplicaciones cliente y proveedores de servicios |
| Función definida a la que llama: |
MAPI |
ULONG (STDAPICALLTYPE NOTIFCALLBACK)(
LPVOID lpvContext,
ULONG cNotification,
LPNOTIFICATION lpNotifications
);
Parameters
lpvContext
[in] Puntero a un valor arbitrario pasado a la función de devolución de llamada cuando MAPI la llama. Este valor puede representar una dirección de importancia para la aplicación cliente o el proveedor de servicios. Normalmente, para el código de C++, el parámetro lpvContext representa un puntero a un objeto de C++.
cNotification
[in] Recuento de notificaciones de eventos en la matriz indicadas por el parámetro lpNotifications .
lpNotifications
[out] Puntero a la ubicación donde esta función escribe una matriz de estructuras NOTIFICATION que contiene las notificaciones de eventos.
Valor devuelto
El conjunto de valores devueltos válidos para el prototipo de función NOTIFCALLBACK depende de si una aplicación cliente o un proveedor de servicios implementa la función. Los clientes siempre deben devolver S_OK. Los proveedores pueden devolver S_OK o CALLBACK_DISCONTINUE.
Comentarios
CALLBACK_DISCONTINUE es un valor devuelto válido solo para las funciones de devolución de llamada sincrónicas; solicita que MAPI detenga inmediatamente el procesamiento de las devoluciones de llamada para esta notificación. Cuando se devuelve CALLBACK_DISCONTINUE, MAPI establece el parámetro lpUlFlags en NOTIFY_CANCELED cuando se devuelve desde IMAPISupport::Notify.
A continuación se indican las limitaciones de lo que puede hacer una función de devolución de llamada sincrónica:
No puede hacer que se genere otra notificación sincrónica.
No puede mostrar una interfaz de usuario.