Compartilhar via


IMAPITable::Unadvise

Aplica-se a: Outlook 2013 | Outlook 2016

Cancela o envio de notificações configuradas anteriormente com uma chamada para o método IMAPITable::Advise .

HRESULT Unadvise(
ULONG_PTR ulConnection
);

Parâmetros

ulConnection

[in] O número da conexão de registro retornada por uma chamada para IMAPITable::Advise.

Valor de retorno

S_OK

A chamada foi bem-sucedida.

Comentários

Use o método IMAPITable::Unadvise para liberar o ponteiro para o objeto de coletor de aconselhamento passado no parâmetro lpAdviseSink na chamada anterior para IMAPITable::Advise, cancelando assim um registro de notificação. Como parte do descarte do ponteiro para o objeto coletor de aconselhamento, o método IUnknown::Release do objeto é chamado. Geralmente, Release é chamado durante a chamada Unadvise , mas se outro thread estiver no processo de chamar o método IMAPIAdviseSink::OnNotify para o coletor de aconselhamento, a chamada de versão será adiada até que o método OnNotify retorne.

Para obter mais informações sobre o processo de notificação, consulte Notificação de Eventos no MAPI. Para obter informações específicas sobre a notificação de tabela, consulte Sobre Notificações de Tabela. Para obter informações sobre como usar os métodos IMAPISupport para dar suporte à notificação, consulte Notificação de Evento de Suporte.

Referência do MFCMAPI

Para ver códigos de exemplo do MFCMAPI, confira a tabela a seguir.

Arquivo Função Comentário
ContentsTableListCtrl.cpp
CContentsTableListCtrl::NotificationOff
O MFCMAPI usa o método IMAPITable::Unadvise para cancelar notificações para a tabela.

Confira também

IMAPIAdviseSink::OnNotify

IMAPITable::Advise

IMAPITable : IUnknown

MFCMAPI como exemplo de código