CALLERRELEASE

S’applique à : Outlook 2013 | Outlook 2016

Définit une fonction de rappel qui peut libérer un objet de données de table lorsqu’une vue de table est publiée.

Propriété	Valeur
Fichier d’en-tête :	Mapiutil.h
Fonction définie implémentée par :	Applications clientes et fournisseurs de services
Fonction définie appelée par :	MAPI

void CALLERRELEASE(
  ULONG_PTR ulCallerData,
  LPTABLEDATA lpTblData,
  LPMAPITABLE lpVue
);

Paramètres

ulCallerData

[in] Données de l’appelant enregistrées par MAPI avec la vue table et transmises à la fonction de rappel basée sur CALLERRELEASE . Les données fournissent un contexte sur la vue table en cours de publication.

lpTblData

[in] Pointeur vers l’interface ITableData : IUnknown pour l’objet de données de table sous-jacent à la vue de table en cours de publication.

lpVue

[in] Pointeur vers l’interface IMAPITable : IUnknown pour la vue de table en cours de publication. Il s’agit d’une interface pour l’objet table retourné dans le paramètre lppMAPITable de la méthode ITableData ::HrGetView qui a créé l’objet à libérer.

Valeur renvoyée

Aucun

Remarques

Une application cliente ou un fournisseur de services qui a rempli un objet de données de table peut appeler ITableData ::HrGetView pour créer une vue triée en lecture seule de la table. L’appel à HrGetView passe un pointeur vers une fonction de rappel basée sur CALLERRELEASE et un contexte à enregistrer avec la vue de table. Lorsque le nombre de références de la vue table revient à zéro et que la vue est libérée, l’implémentation IMAPITable appelle la fonction de rappel, en transmettant le contexte dans le paramètre ulCallerData .

Une utilisation courante d’une fonction de rappel basée sur CALLERRELEASE consiste à libérer l’objet de données de table sous-jacent et à ne pas avoir à en effectuer le suivi pendant le traitement ultérieur.