HrAllocAdviseSink

S’applique à : Outlook 2013 | Outlook 2016

Crée un objet récepteur de conseil, en fonction d’un contexte spécifié par l’implémentation appelante et d’une fonction de rappel à déclencher par une notification d’événement.

Propriété	Valeur
Fichier d’en-tête :	Mapiutil.h
Implémenté par :	MAPI
Appelé par :	Applications clientes et fournisseurs de services

STDAPI HrAllocAdviseSink(
  LPNOTIFCALLBACK lpfnCallback,
  LPVOID lpvContext,
  LPMAPIADVISESINK FAR * lppAdviseSink
);

Paramètres

lpfnCallback

[in] Pointeur vers une fonction de rappel basée sur le prototype NOTIFCALLBACK que MAPI doit appeler lorsqu’un événement de notification se produit pour le récepteur de conseil nouvellement créé.

lpvContext

[in] Pointeur vers les données de l’appelant passées à la fonction de rappel lorsque MAPI l’appelle. Les données de l’appelant peuvent représenter une adresse importante pour le client ou le fournisseur. En règle générale, pour le code C++, le paramètre lpvContext représente un pointeur vers l’adresse d’un objet.

lppAdviseSink

[out] Pointeur vers un pointeur vers un objet récepteur de conseil.

Valeur renvoyée

Aucun.

Remarques

Pour utiliser la fonction HrAllocAdviseSink , une application cliente ou un fournisseur de services crée un objet pour recevoir des notifications, crée une fonction de rappel de notification basée sur le prototype de fonction NOTIFCALLBACK qui accompagne cet objet et transmet un pointeur à l’objet dans la fonction HrAllocAdviseSink en tant que valeur lpvContext . Cela permet d’effectuer une notification ; et dans le cadre du processus de notification, MAPI appelle la fonction de rappel avec le pointeur d’objet comme contexte.

MAPI implémente son moteur de notification de manière asynchrone. En C++, le rappel de notification peut être une méthode objet. Si l’objet générant la notification n’est pas présent, le client ou le fournisseur qui demande la notification doit conserver un nombre de références distinct pour cet objet pour le récepteur de conseil de l’objet.

Attention

HrAllocAdviseSink doit être utilisé avec parcimonie ; il est plus sûr pour les clients de créer leurs propres récepteurs de conseil.