NOTIFCALLBACK
Aplica-se a: Outlook 2013 | Outlook 2016
Define uma função de retorno de chamada que MAPI chama para enviar uma notificação de evento. Essa função de retorno de chamada só pode ser usada quando encapsulada em um objeto de coletor de aconselhamento criado chamando a função HrAllocAdviseSink .
| Propriedade | Valor |
|---|---|
| Arquivo de cabeçalho: |
Mapidefs.h |
| Função definida implementada por: |
Aplicativos cliente e provedores de serviços |
| Função definida chamada por: |
MAPI |
ULONG (STDAPICALLTYPE NOTIFCALLBACK)(
LPVOID lpvContext,
ULONG cNotification,
LPNOTIFICATION lpNotifications
);
Parâmetros
lpvContext
[in] Ponteiro para um valor arbitrário passado para a função de retorno de chamada quando MAPI a chama. Esse valor pode representar um endereço de significância para o aplicativo cliente ou provedor de serviços. Normalmente, para o código C++, o parâmetro lpvContext representa um ponteiro para um objeto C++.
cNotification
[in] Contagem de notificações de evento na matriz indicada pelo parâmetro lpNotifications .
lpNotifications
[out] Ponteiro para o local em que essa função grava uma matriz de estruturas notification que contém as notificações de evento.
Valor de retorno
O conjunto de valores retornados válidos para o protótipo da função NOTIFCALLBACK depende se a função é implementada por um aplicativo cliente ou um provedor de serviços. Os clientes sempre devem retornar S_OK. Os provedores podem retornar S_OK ou CALLBACK_DISCONTINUE.
Comentários
CALLBACK_DISCONTINUE é um valor retornado válido apenas para funções de retorno de chamada síncronas; ele solicita que o MAPI pare imediatamente de processar os retornos de chamada para essa notificação. Quando CALLBACK_DISCONTINUE é retornado, o MAPI define o parâmetro lpUlFlags como NOTIFY_CANCELED quando retorna de IMAPISupport::Notify.
Veja a seguir as limitações sobre o que uma função de retorno de chamada síncrona pode fazer:
Não pode fazer com que outra notificação síncrona seja gerada.
Ele não pode exibir uma interface do usuário.