Método IAddrBook::Advise (wabiab.h)

Registra el autor de la llamada con la Libreta de direcciones de Windows (WAB) para recibir notificaciones.

Syntax

HRESULT Advise(
  ULONG            cbEntryID,
  LPENTRYID        lpEntryID,
  ULONG            ulEventMask,
  LPMAPIADVISESINK lpAdviseSink,
  ULONG            *lpulConnection
);

Parámetros

cbEntryID

Reservado. Debe establecerse en 0.

lpEntryID

Reservado. Debe establecerse en NULL.

ulEventMask

Valor de tipo ULONG que especifica las máscaras de eventos. Establezca en fnevObjectModified. Se rechazarán todas las demás máscaras de eventos.

lpAdviseSink

Puntero a una interfaz IUnknown que especifica el objeto invocado por la Libreta de direcciones de Windows (WAB) para enviar notificaciones.

lpulConnection

Puntero a una variable de tipo ULONG que recibe el número de conexión devuelto por la Libreta de direcciones de Windows (WAB). Use este número al llamar a IAddrBook::Unadvise.

Valor devuelto

HRESULT

Observaciones

En este momento, la libreta de direcciones de Windows (WAB) solo proporciona notificaciones a los cambios genéricos en el almacén. Los clientes no se pueden registrar para las notificaciones proporcionadas por identificador de entrada. Cuando cambia el almacén de la Libreta de direcciones de Windows (WAB), la Libreta de direcciones de Windows (WAB) invoca el método IMAPIAdviseSink::OnNotify en el puntero lpAdviseSink pasado a esta función.

La estructura NOTIFICATION que se pasa al método **OnNotify tiene los siguientes miembros válidos:

<![CDATA[Notification.ulEventType = fnevObjectModified
Notification.info.obj.ulObjType = MAPI_ADDRBOOK]]>

Todos los demás miembros de la estructura serán NULL o cero. Los clientes deben usar esta notificación solo para actualizar su interfaz de usuario. La información detallada sobre las modificaciones en objetos individuales dentro de la Libreta de direcciones de Windows (WAB) no está disponible actualmente.

Requisitos

Requirement	Importancia
Cliente mínimo compatible	Compilación 20348 de Windows 10
servidor mínimo admitido	Compilación 20348 de Windows 10
Header	wabiab.h