IMAPIViewContext::SetAdviseSink
Aplica-se a: Outlook 2013 | Outlook 2016
Gerencia o registro de um formulário para receber notificações sobre alterações no visualizador.
HRESULT SetAdviseSink(
LPMAPIFORMADVISESINK pmvns
);
Parâmetros
pmvns
[in] Ponteiro para um formulário aconselha objeto de coletor ou NULL.
Valor de retorno
S_OK
O registro ou cancelamento da notificação de formulário foi bem-sucedido.
Comentários
Objetos de formulário chamam o método IMAPIViewContext::SetAdviseSink para se registrar para saber mais sobre as alterações no visualizador de formulários ou cancelar um registro anterior. Quando o pmvns é definido como NULL, o formulário deseja cancelar um registro. Quando pmvns aponta para um coletor de aconselhamento de formulário válido, o formulário deseja registrar-se para notificações futuras.
Observações para implementadores
Quando SetAdviseSink incluir um ponteiro de coletor de conselhos de formulário, mantenha uma referência a ele até que outra chamada SetAdviseSink seja feita para cancelar a notificação. Envie uma notificação quando ocorrer uma alteração no visualizador e quando você estiver carregando uma nova mensagem.
Para obter mais informações, confira Envio e Recebimento de Notificações de Formulário.
Referência do MFCMAPI
Para ver códigos de exemplo do MFCMAPI, confira a tabela a seguir.
| Arquivo | Função | Comentário |
|---|---|---|
| MyMAPIFormViewer.cpp |
CMyMAPIFormViewer::SetAdviseSink |
O MFCMAPI implementa o método IMAPIViewContext::SetAdviseSink nesta função. |