IMAPIViewContext::SetAdviseSink
Hace referencia a: Outlook 2013 | Outlook 2016
Administra el registro de un formulario para recibir notificaciones sobre los cambios en el visor.
HRESULT SetAdviseSink(
LPMAPIFORMADVISESINK pmvns
);
Parameters
pmvns
[in] Puntero a un objeto receptor de aviso de formulario o NULL.
Valor devuelto
S_OK
El registro o cancelación de la notificación del formulario se realizó correctamente.
Comentarios
Los objetos Form llaman al método IMAPIViewContext::SetAdviseSink para registrarse para obtener información sobre los cambios en el visor de formularios o cancelar un registro anterior. Cuando pmvns se establece en NULL, el formulario quiere cancelar un registro. Cuando pmvns apunta a un receptor de aviso de formulario válido, el formulario quiere registrarse para futuras notificaciones.
Notas a los implementadores
Cuando SetAdviseSink incluya un puntero receptor de aviso de formulario, mantenga una referencia a él hasta que se realice otra llamada a SetAdviseSink para cancelar la notificación. Envíe una notificación cuando se produzca un cambio en el visor y cuando cargue un mensaje nuevo.
Para obtener más información, vea Envío y recepción de notificaciones de formulario.
Referencia de MFCMAPI
Para obtener un ejemplo de código de MFCMAPI, vea la siguiente tabla.
| Archivo | Función | Comment |
|---|---|---|
| MyMAPIFormViewer.cpp |
CMyMAPIFormViewer::SetAdviseSink |
MFCMAPI implementa el método IMAPIViewContext::SetAdviseSink en esta función. |