NOTIFICATION
S’applique à : Outlook 2013 | Outlook 2016
Contient des informations sur un événement qui s’est produit et les données qui ont été affectées par l’événement.
| Propriété | Valeur |
|---|---|
| Fichier d’en-tête : |
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
Type d’événement de notification qui s’est produit. La valeur du membre ulEventType correspond à la structure incluse dans l’union d’informations . Le membre ulEventType peut être défini sur l’une des valeurs suivantes :
fnevCriticalError
Une erreur globale s’est produite, comme l’arrêt d’une session en cours. Le membre d’informations contient une structure ERROR_NOTIFICATION .
fnevExtended
Un événement interne défini par un fournisseur de services particulier s’est produit. Le membre d’informations contient une structure EXTENDED_NOTIFICATION .
fnevNewMail
Un message a été remis au dossier de réception approprié pour la classe de message et attend d’être traité. Le membre d’informations contient une structure NEWMAIL_NOTIFICATION .
fnevObjectCopied
Un objet MAPI a été copié. Le membre d’informations contient une structure OBJECT_NOTIFICATION .
fnevObjectCreated
Un objet MAPI a été créé. Le membre d’informations contient une structure OBJECT_NOTIFICATION .
fnevObjectDeleted
Un objet MAPI a été supprimé. Le membre d’informations contient une structure OBJECT_NOTIFICATION .
fnevObjectModified
Un objet MAPI a changé. Le membre d’informations contient une structure OBJECT_NOTIFICATION .
fnevObjectMoved
Un objet de magasin de messages ou de carnet d’adresses a été déplacé. Le membre d’informations contient une structure OBJECT_NOTIFICATION .
fnevSearchComplete
Une opération de recherche est terminée et les résultats sont disponibles. Le membre d’informations contient une structure OBJECT_NOTIFICATION .
fnevTableModified
Les informations d’une table ont changé. Le membre d’informations contient une structure TABLE_NOTIFICATION .
info
Union de structures de notification décrivant les données affectées pour un type particulier d’événement. La structure incluse dans le membre info dépend de la valeur du membre ulEventType .
Remarques
Une ou plusieurs structures NOTIFICATION sont passées en tant que paramètres d’entrée à chaque appel à la méthode IMAPIAdviseSink ::OnNotify d’un récepteur de conseil inscrit. Les structures NOTIFICATION contiennent des informations sur les événements particuliers qui se sont produits et décrivent les objets affectés.
Avant que les clients ou les fournisseurs de services recevant une notification puissent utiliser la structure pour traiter l’événement, ils doivent case activée le type d’événement comme indiqué dans le membre ulEventType. Par exemple, l’exemple de code présenté ici vérifie l’arrivée d’un nouveau message et, lors de la détection d’un événement de ce type, imprime la classe de message du message.
if (pNotif -> ulEventType == fnevNewMail)
{
printf("%s\n", pNotif -> newmail.lpszMessageClass)
}
Pour plus d’informations sur la notification, consultez les rubriques décrites dans le tableau suivant.
| Rubrique | Description |
|---|---|
|
Notification d’événement dans MAPI |
Vue d’ensemble générale des événements de notification et de notification. |
|
Gestion des notifications |
Discussion sur la façon dont les clients doivent gérer les notifications. |
|
Notification d’événement de prise en charge |
Discussion sur la façon dont les fournisseurs de services peuvent utiliser la méthode IMAPISupport pour générer des notifications. |