Compartilhar via

NOTIFICATION

  • Artigo

Aplica-se a: Outlook 2013 | Outlook 2016

Contém informações sobre um evento que ocorreu e os dados que foram afetados pelo evento.

Propriedade Valor
Arquivo de cabeçalho:
 Mapidefs.h
 
typedef struct
{
  ULONG ulEventType;
  union
  {
    ERROR_NOTIFICATION err;
    NEWMAIL_NOTIFICATION newmail;
    OBJECT_NOTIFICATION obj;
    TABLE_NOTIFICATION tab;
    EXTENDED_NOTIFICATION ext;
    STATUS_OBJECT_NOTIFICATION statobj;
  } info;
} NOTIFICATION, FAR *LPNOTIFICATION;

Members

Uleventtype

Tipo de evento de notificação que ocorreu. O valor do membro ulEventType corresponde à estrutura incluída na união de informações . O membro ulEventType pode ser definido como um dos seguintes valores:

fnevCriticalError

Ocorreu um erro global, como um desligamento de sessão em andamento. O membro de informações contém uma estrutura ERROR_NOTIFICATION .

fnevExtended

Ocorreu um evento interno definido por um determinado provedor de serviços. O membro de informações contém uma estrutura EXTENDED_NOTIFICATION .

fnevNewMail

Uma mensagem foi entregue à pasta de recebimento apropriada para a classe de mensagem e está aguardando para ser processada. O membro de informações contém uma estrutura NEWMAIL_NOTIFICATION .

fnevObjectCopied

Um objeto MAPI foi copiado. O membro de informações contém uma estrutura OBJECT_NOTIFICATION .

fnevObjectCreated

Um objeto MAPI foi criado. O membro de informações contém uma estrutura OBJECT_NOTIFICATION .

fnevObjectDeleted

Um objeto MAPI foi excluído. O membro de informações contém uma estrutura OBJECT_NOTIFICATION .

fnevObjectModified

Um objeto MAPI foi alterado. O membro de informações contém uma estrutura OBJECT_NOTIFICATION .

fnevObjectMoved

Um objeto do repositório de mensagens ou do catálogo de endereços foi movido. O membro de informações contém uma estrutura OBJECT_NOTIFICATION .

fnevSearchComplete

Uma operação de pesquisa foi concluída e os resultados estão disponíveis. O membro de informações contém uma estrutura OBJECT_NOTIFICATION .

fnevTableModified

As informações em uma tabela foram alteradas. O membro de informações contém uma estrutura TABLE_NOTIFICATION .

informações

União de estruturas de notificação que descrevem os dados afetados para um determinado tipo de evento. A estrutura incluída no membro de informações depende do valor do membro ulEventType .

Comentários

Uma ou mais estruturas notification são passadas como parâmetros de entrada a cada chamada para um método IMAPIAdviseSink::OnNotify do coletor registrado. As estruturas NOTIFICATION contêm informações sobre os eventos específicos que ocorreram e descrevem os objetos afetados.

Antes que clientes ou provedores de serviços que recebem uma notificação possam usar a estrutura para processar o evento, eles devem marcar o tipo de evento, conforme indicado no membro ulEventType. Por exemplo, o exemplo de código mostrado aqui verifica a chegada de uma nova mensagem e, ao detectar um evento desse tipo, imprime a classe de mensagem da mensagem.

if (pNotif -> ulEventType == fnevNewMail)
{
printf("%s\n", pNotif -> newmail.lpszMessageClass)
}

Para obter mais informações sobre a notificação, confira os tópicos descritos na tabela a seguir.

Tópico Descrição
Notificação de eventos no MAPI
Visão geral dos eventos de notificação e notificação.
Manipulando notificações
Discussão sobre como os clientes devem lidar com as notificações.
Notificações de eventos de suporte
Discussão sobre como os provedores de serviços podem usar o método IMAPISupport para gerar notificações.

Confira também