IMAPIForm::Advise
Hace referencia a: Outlook 2013 | Outlook 2016
Registra un visor de formularios para recibir notificaciones sobre eventos que afectan al formulario.
HRESULT Advise(
LPMAPIVIEWADVISESINK pAdvise,
ULONG FAR * pulConnection
);
Parameters
pAdvise
[in] Un puntero a una vista aconseja al objeto receptor que reciba las notificaciones posteriores.
pulConnection
[out] Puntero a un valor distinto de cero que representa un registro de notificación correcto.
Valor devuelto
S_OK
El registro se realizó correctamente.
E_OUTOFMEMORY
El registro no se realizó correctamente debido a la falta de memoria.
Comentarios
Los visores de formularios llaman al método IMAPIForm::Advise de un formulario para registrarse para recibir notificaciones cuando se produzcan cambios en el formulario.
Notas a los implementadores
Mantenga una copia del puntero del receptor de aviso de vista pasado en el parámetro pAdvise para que pueda usarlo para llamar al método IMAPIViewAdviseSink adecuado cuando se produzca un evento. Llame al método IUnknown::AddRef del receptor de aviso de la vista para conservar el puntero hasta que se cancele el registro de notificaciones. Establezca el contenido del parámetro pulConnection en un número distinto de cero.
Muchos formularios implementan un objeto auxiliar para controlar el registro y la notificación posterior de eventos.
Para obtener más información sobre el proceso de notificación en general, vea Notificación de eventos en MAPI.
Para obtener más información sobre las notificaciones y formularios, vea Envío y recepción de notificaciones de formulario.
Vea también
IMAPIViewAdviseSink : IUnknown