IMAPITable::QuerySortOrder
S’applique à : Outlook 2013 | Outlook 2016
Récupère l’ordre de tri actuel pour une table.
HRESULT QuerySortOrder(
LPSSortOrderSet FAR * lppSortCriteria
);
Paramètres
lppSortCriteria
[out] Pointeur vers un pointeur vers la structure SSortOrderSet contenant l’ordre de tri actuel.
Valeur renvoyée
S_OK
L’ordre de tri actuel a été retourné avec succès.
MAPI_E_BUSY
Une autre opération est en cours qui empêche l’opération de récupération de l’ordre de tri de démarrer. Soit l’opération en cours doit être autorisée à se terminer, soit elle doit être arrêtée.
Remarques
La méthode IMAPITable ::QuerySortOrder récupère l’ordre de tri actuel pour une table. Les ordres de tri sont décrits avec une structure SSortOrderSet .
Le membre cSorts de la structure SSortOrderSet peut être défini sur zéro si :
La table n’est pas triée.
Il n’existe aucune information sur la façon dont la table est triée.
La structure SSortOrderSet n’est pas appropriée pour décrire l’ordre de tri.
Remarques pour les responsables de l’implémentation
Si un appel est effectué à votre méthode IMAPITable ::SortTable avec une structure SSortOrderSet contenant zéro colonne dans la clé de tri, supprimez l’ordre de tri actuel et appliquez l’ordre par défaut, le cas échéant. Dans les appels suivants à QuerySortOrder, vous pouvez choisir de retourner zéro ou plusieurs colonnes pour la clé de tri. Vous pouvez retourner plus de colonnes que dans la vue actuelle.
Pour plus d’informations sur le tri, consultez Tri et catégorisation.