IMAPIForm::Advise
Aplica-se a: Outlook 2013 | Outlook 2016
Registra um visualizador de formulários para notificações sobre eventos que afetam o formulário.
HRESULT Advise(
LPMAPIVIEWADVISESINK pAdvise,
ULONG FAR * pulConnection
);
Parâmetros
pAdvise
[in] Um ponteiro para uma exibição aconselha o objeto coletor a receber as notificações subsequentes.
pulConnection
[out] Um ponteiro para um valor não zero que representa um registro de notificação bem-sucedido.
Valor de retorno
S_OK
O registro foi bem-sucedido.
E_OUTOFMEMORY
O registro não foi bem sucedido devido à memória insuficiente.
Comentários
Os visualizadores de formulário chamam o método IMAPIForm::Advise de um formulário para se registrar para notificação quando ocorrerem alterações no formulário.
Observações para implementadores
Mantenha uma cópia do ponteiro do coletor de conselhos de exibição passado no parâmetro pAdvise para que você possa usá-lo para chamar o método IMAPIViewAdviseSink apropriado quando ocorrer um evento. Chame o modo de exibição para aconselhar o método IUnknown::AddRef do coletor a manter o ponteiro até que o registro de notificação seja cancelado. Defina o conteúdo do parâmetro pulConnection como um número não zero.
Muitos formulários implementam um objeto auxiliar para lidar com o registro e a notificação subsequente de eventos.
Para obter mais informações sobre o processo de notificação em geral, consulte Notificação de Eventos no MAPI.
Para obter mais informações sobre notificação e formulários, consulte Envio e Recebimento de Notificações de Formulário.
Confira também
IMAPIViewAdviseSink : IUnknown