IMAPITable::CreateBookmark
S’applique à : Outlook 2013 | Outlook 2016
Crée un signet à la position actuelle de la table.
HRESULT CreateBookmark(
BOOKMARK FAR * lpbkPosition
);
Paramètres
lpbkPosition
[out] Pointeur vers la valeur de signet 32 bits retournée. Ce signet peut ensuite être passé dans un appel à la méthode IMAPITable ::SeekRow .
Valeur renvoyée
S_OK
L'appel a r�ussi et a renvoy� la valeur attendue ou les valeurs.
MAPI_E_UNABLE_TO_COMPLETE
L’opération demandée n’a pas pu être terminée.
Remarques
La méthode IMAPITable ::CreateBookmark marque une position de table en créant une valeur appelée signet. Un signet peut être utilisé pour revenir à la position identifiée par le signet. La position avec signet est associée à l’objet au niveau de cette ligne dans le tableau.
Les signets ne sont pas pris en charge sur les tables de pièces jointes, et les implémentations de table de pièces jointes de CreateBookmark retournent MAPI_E_NO_SUPPORT.
Remarques pour les responsables de l’implémentation
En raison des dépenses de mémoire liées à la gestion des positions des curseurs avec des signets, limitez le nombre de signets que vous pouvez créer. Lorsque vous atteignez ce numéro, retournez MAPI_E_UNABLE_TO_COMPLETE de tous les appels suivants à CreateBookmark.
Parfois, un signet pointe vers une ligne qui n’est plus dans la vue de tableau. Si un appelant utilise un tel signet, déplacez le curseur vers la ligne visible suivante et arrêtez-y.
Lorsque l’appelant tente d’utiliser un signet qui pointe vers une ligne non invisible parce qu’elle a été réduite, retournez MAPI_W_POSITION_CHANGED après le déplacement du signet. Vous pouvez repositionner le signet sur la ligne visible suivante à ce moment ou lorsque la réduction se produit dans la méthode SetCollapseState . Si vous déplacez le signet au moment où la ligne est réduite, vous devez conserver un bit dans le signet qui indique exactement quand le signet a été déplacé : depuis sa dernière utilisation ou s’il n’a jamais été utilisé depuis sa création.
Remarques pour les appelants
CreateBookmark alloue de la mémoire pour le signet qu’il crée. Libérez les ressources du signet en appelant la méthode IMAPITable ::FreeBookmark .