HrAllocAdviseSink

Hace referencia a: Outlook 2013 | Outlook 2016

Crea un objeto receptor advise, dado un contexto especificado por la implementación de llamada y una función de devolución de llamada que se desencadenará mediante una notificación de eventos.

Propiedad	Valor
Archivo de encabezado:	Mapiutil.h
Implementado por:	MAPI
Llamado por:	Aplicaciones cliente y proveedores de servicios

STDAPI HrAllocAdviseSink(
  LPNOTIFCALLBACK lpfnCallback,
  LPVOID lpvContext,
  LPMAPIADVISESINK FAR * lppAdviseSink
);

Parameters

lpfnCallback

[in] Puntero a una función de devolución de llamada basada en el prototipo NOTIFCALLBACK al que MAPI debe llamar cuando se produce un evento de notificación para el receptor de aviso recién creado.

lpvContext

[in] Puntero a los datos del llamador pasados a la función de devolución de llamada cuando MAPI lo llama. Los datos del autor de la llamada pueden representar una dirección de importancia para el cliente o proveedor. Normalmente, para el código de C++, el parámetro lpvContext representa un puntero a la dirección de un objeto.

lppAdviseSink

[out] Puntero a un puntero a un objeto receptor advise.

Valor devuelto

Ninguno.

Comentarios

Para usar la función HrAllocAdviseSink , una aplicación cliente o un proveedor de servicios crea un objeto para recibir notificaciones, crea una función de devolución de llamada de notificación basada en el prototipo de función NOTIFCALLBACK que va con ese objeto y pasa un puntero al objeto en la función HrAllocAdviseSink como valor lpvContext . Al hacerlo, se realiza una notificación; y como parte del proceso de notificación, MAPI llama a la función de devolución de llamada con el puntero de objeto como contexto.

MAPI implementa su motor de notificaciones de forma asincrónica. En C++, la devolución de llamada de notificación puede ser un método de objeto. Si el objeto que genera la notificación no está presente, el cliente o proveedor que solicita la notificación debe mantener un recuento de referencias independiente para ese objeto para el receptor de aviso del objeto.

Precaución

HrAllocAdviseSink debe usarse con moderación; es más seguro para los clientes crear sus propios receptores de aviso.