NOTIFICATION
Область применения: Outlook 2013 | Outlook 2016
Содержит сведения о событии, которое произошло, и данные, на которые повлияло событие.
| Свойство | Значение |
|---|---|
| Файл заголовка: |
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
Тип события уведомления, которое произошло. Значение элемента ulEventType соответствует структуре, включенной в информационное объединение. Для элемента ulEventType можно задать одно из следующих значений:
fnevCriticalError
Произошла глобальная ошибка, например завершение сеанса. Элемент info содержит структуру ERROR_NOTIFICATION .
fnevExtended
Произошло внутреннее событие, определенное определенным поставщиком услуг. Элемент info содержит структуру EXTENDED_NOTIFICATION .
fnevNewMail
Сообщение доставлено в соответствующую папку получения для класса сообщений и ожидает обработки. Элемент info содержит структуру NEWMAIL_NOTIFICATION .
fnevObjectCopied
Объект MAPI скопирован. Элемент info содержит структуру OBJECT_NOTIFICATION .
fnevObjectCreated
Создан объект MAPI. Элемент info содержит структуру OBJECT_NOTIFICATION .
fnevObjectDeleted
Объект MAPI удален. Элемент info содержит структуру OBJECT_NOTIFICATION .
fnevObjectModified
Объект MAPI изменен. Элемент info содержит структуру OBJECT_NOTIFICATION .
fnevObjectMoved
Хранилище сообщений или объект адресной книги перемещен. Элемент info содержит структуру OBJECT_NOTIFICATION .
fnevSearchComplete
Операция поиска завершена, и результаты доступны. Элемент info содержит структуру OBJECT_NOTIFICATION .
fnevTableModified
Сведения в таблице изменились. Элемент info содержит структуру TABLE_NOTIFICATION .
info
Объединение структур уведомлений, описывающих затронутые данные для определенного типа события. Структура, включенная в элемент info , зависит от значения элемента ulEventType .
Замечания
Одна или несколько структур NOTIFICATION передаются в качестве входных параметров при каждом вызове метода IMAPIAdviseSink::OnNotify зарегистрированного приемника рекомендаций. Структуры NOTIFICATION содержат сведения о конкретных событиях, которые произошли, и описывают затронутые объекты.
Прежде чем клиенты или поставщики услуг, получающие уведомление, смогут использовать структуру для обработки события, они должны проверка тип события, как указано в элементе ulEventType. Например, приведенный здесь пример кода проверяет наличие поступления нового сообщения и при обнаружении события такого рода выводит класс сообщения.
if (pNotif -> ulEventType == fnevNewMail)
{
printf("%s\n", pNotif -> newmail.lpszMessageClass)
}
Дополнительные сведения об уведомлениях см. в разделах, описанных в следующей таблице.
| Статья | Описание |
|---|---|
|
Уведомление о событиях в MAPI |
Общие сведения о событиях уведомлений и уведомлений. |
|
Обработка уведомлений |
Обсуждение того, как клиенты должны обрабатывать уведомления. |
|
Поддержка уведомлений о событиях |
Обсуждение того, как поставщики услуг могут использовать метод IMAPISupport для создания уведомлений. |