Partager via

NOTIFCALLBACK

  • Article

S’applique à : Outlook 2013 | Outlook 2016

Définit une fonction de rappel que MAPI appelle pour envoyer une notification d’événement. Cette fonction de rappel ne peut être utilisée que lorsqu’elle est encapsulée dans un objet récepteur de conseil créé en appelant la fonction HrAllocAdviseSink .

Propriété Valeur
Fichier d’en-tête :
 Mapidefs.h
Fonction définie implémentée par :
 Applications clientes et fournisseurs de services
Fonction définie appelée par :
 MAPI
 
ULONG (STDAPICALLTYPE NOTIFCALLBACK)(
  LPVOID lpvContext,
  ULONG cNotification,
  LPNOTIFICATION lpNotifications
);

Paramètres

lpvContext

[in] Pointeur vers une valeur arbitraire passée à la fonction de rappel lorsque MAPI l’appelle. Cette valeur peut représenter une adresse importante pour l’application cliente ou le fournisseur de services. En règle générale, pour le code C++, le paramètre lpvContext représente un pointeur vers un objet C++.

cNotification

[in] Nombre de notifications d’événements dans le tableau indiqué par le paramètre lpNotifications .

lpNotifications

[out] Pointeur vers l’emplacement où cette fonction écrit un tableau de structures NOTIFICATION qui contient les notifications d’événements.

Valeur renvoyée

L’ensemble de valeurs de retour valides pour le prototype de fonction NOTIFCALLBACK varie selon que la fonction est implémentée par une application cliente ou un fournisseur de services. Les clients doivent toujours retourner S_OK. Les fournisseurs peuvent retourner S_OK ou CALLBACK_DISCONTINUE.

Remarques

CALLBACK_DISCONTINUE est une valeur de retour valide uniquement pour les fonctions de rappel synchrones ; il demande que MAPI arrête immédiatement le traitement des rappels pour cette notification. Quand CALLBACK_DISCONTINUE est retourné, MAPI définit le paramètre lpUlFlags sur NOTIFY_CANCELED lorsqu’il retourne à partir de IMAPISupport ::Notify.

Voici les limitations relatives à ce qu’une fonction de rappel synchrone peut faire :

  • Elle ne peut pas entraîner la génération d’une autre notification synchrone.

  • Il ne peut pas afficher une interface utilisateur.

Voir aussi

IMAPIAdviseSink::OnNotify