Export (0) Print
Expand All

IMAPITable::QuerySortOrder

Last modified: January 16, 2009

Applies to: Office 2010 | Outlook 2010 | Visual Studio

Retrieves the current sort order for a table.

HRESULT QuerySortOrder(
LPSSortOrderSet FAR * lppSortCriteria
);

lppSortCriteria

[out] Pointer to a pointer to the SSortOrderSet structure holding the current sort order.

S_OK

The current sort order was successfully returned.

MAPI_E_BUSY

Another operation is in progress that prevents the sort order retrieval operation from starting. Either the operation in progress should be allowed to complete or it should be stopped.

The IMAPITable::QuerySortOrder method retrieves the current sort order for a table. Sort orders are described with an SSortOrderSet structure.

  • The cSorts member of the SSortOrderSet structure can be set to zero if:

  • The table is unsorted.

  • There is no information about how the table is sorted.

  • The SSortOrderSet structure is not appropriate for describing the sort order.

If a call is made to your IMAPITable::SortTable method with an SSortOrderSet structure containing zero columns in the sort key, remove the current sort order and apply the default order, if there is one. In subsequent calls to QuerySortOrder, you can choose whether to return zero or more columns for the sort key. You can return more columns than are in the present view.

For more information about sorting, see Sorting and Categorization.

Show:
© 2015 Microsoft