IMAPITable::QuerySortOrder
Aplica-se a: Outlook 2013 | Outlook 2016
Recupera a ordem de classificação atual de uma tabela.
HRESULT QuerySortOrder(
LPSSortOrderSet FAR * lppSortCriteria
);
Parâmetros
lppSortCriteria
[out] Ponteiro para um ponteiro para a estrutura SSortOrderSet que contém a ordem de classificação atual.
Valor de retorno
S_OK
A ordem de classificação atual foi retornada com êxito.
MAPI_E_BUSY
Outra operação está em andamento que impede o início da operação de recuperação de ordem de classificação. A operação em andamento deve ser autorizada a ser concluída ou deve ser interrompida.
Comentários
O método IMAPITable::QuerySortOrder recupera a ordem de classificação atual de uma tabela. Os pedidos de classificação são descritos com uma estrutura SSortOrderSet .
O membro cSorts da estrutura SSortOrderSet pode ser definido como zero se:
A tabela não é variada.
Não há informações sobre como a tabela é classificada.
A estrutura SSortOrderSet não é apropriada para descrever a ordem de classificação.
Observações para implementadores
Se uma chamada for feita ao método IMAPITable::SortTable com uma estrutura SSortOrderSet contendo zero colunas na chave de classificação, remova a ordem de classificação atual e aplique a ordem padrão, se houver uma. Em chamadas subsequentes para QuerySortOrder, você pode escolher se deseja retornar zero ou mais colunas para a chave de classificação. Você pode retornar mais colunas do que no modo de exibição atual.
Para obter mais informações sobre classificação, consulte Classificação e Categorização.