IMAPIForm::Advise
S’applique à : Outlook 2013 | Outlook 2016
Inscrit une visionneuse de formulaires pour les notifications relatives aux événements qui affectent le formulaire.
HRESULT Advise(
LPMAPIVIEWADVISESINK pAdvise,
ULONG FAR * pulConnection
);
Paramètres
pAdvise
[in] Un pointeur vers une vue conseille à l’objet récepteur de recevoir les notifications suivantes.
pulConnection
[out] Pointeur vers une valeur différente de zéro qui représente une inscription de notification réussie.
Valeur renvoyée
S_OK
L’inscription a réussi.
E_OUTOFMEMORY
L’inscription a échoué en raison d’une mémoire insuffisante.
Remarques
Les visionneuses de formulaires appellent la méthode IMAPIForm ::Advise d’un formulaire pour s’inscrire à la notification lorsque des modifications se produisent dans le formulaire.
Remarques pour les responsables de l’implémentation
Conservez une copie du pointeur récepteur de notification de vue passé dans le paramètre pAdvise afin de pouvoir l’utiliser pour appeler la méthode IMAPIViewAdviseSink appropriée lorsqu’un événement se produit. Appelez la méthode IUnknown ::AddRef du récepteur de la vue pour conserver le pointeur jusqu’à ce que l’inscription de la notification soit annulée. Définissez le contenu du paramètre pulConnection sur un nombre différent de zéro.
De nombreux formulaires implémentent un objet d’assistance pour gérer l’inscription et la notification ultérieure des événements.
Pour plus d’informations sur le processus de notification en général, consultez Notification d’événements dans MAPI.
Pour plus d’informations sur les notifications et les formulaires, consultez Envoi et réception de notifications par formulaire.
Voir aussi
IMAPIViewAdviseSink : IUnknown