ITableData::HrGetView
S’applique à : Outlook 2013 | Outlook 2016
Crée une vue de table, renvoyant un pointeur vers une implémentation IMAPITable .
HRESULT HrGetView(
LPSSortOrderSet lpSSortOrderSet,
CALLERRELEASE FAR * lpfCallerRelease,
ULONG_PTR ulCallerData,
LPMAPITABLE FAR * lppMAPITable
);
Paramètres
lpSSortOrderSet
[in] Pointeur vers une structure d’ordre de tri qui décrit l’ordre de tri pour la vue table. Si NULL est passé dans le paramètre lpSSortOrderSet , la vue n’est pas triée.
lpfCallerRelease
[in] Pointeur vers une fonction de rappel basée sur le prototype CALLERRELEASE que MAPI appelle lorsqu’il libère la vue. Si NULL est passé dans le paramètre lpfCallerRelease , aucune fonction n’est appelée lors de la mise en production de la vue.
ulCallerData
[in] Données qui doivent être enregistrées avec la nouvelle vue et passées à la fonction de rappel pointée par lpfCallerRelease.
lppMAPITable
[out] Pointeur vers un pointeur vers la vue nouvellement créée.
Valeur renvoyée
S_OK
La vue a été créée avec succès.
Remarques
La méthode ITableData ::HrGetView crée une vue en lecture seule des données de la table, triée dans l’ordre indiqué par le paramètre lpSSortOrderSet . Le curseur est placé au début de la première ligne de la vue. Une implémentation de l’interface IMAPITable pour accéder à la vue est retournée.
Les fournisseurs de services appellent HrGetView lorsqu’ils doivent accorder à un client l’accès à une table. HrGetView crée la vue et retourne le pointeur IMAPITable . Les fournisseurs de services passent à leur tour le pointeur au client. Lorsque le client a fini d’utiliser la table et appelle sa méthode IUnknown ::Release , HrGetView appelle la fonction de rappel pointée par le paramètre lpfCallerRelease .
Si un fournisseur de services doit retourner à un client une vue qui a un jeu de colonnes personnalisé ou une restriction, le fournisseur peut appeler les méthodes IMAPITable ::SetColumns et IMAPITable ::Restrict de l’affichage avant d’autoriser l’accès au client.