IMAPITable::GetStatus
Aplica-se a: Outlook 2013 | Outlook 2016
Retorna o status e o tipo da tabela.
HRESULT GetStatus(
ULONG FAR * lpulTableStatus,
ULONG FAR * lpulTableType
);
Parâmetros
lpulTableStatus
[out] Ponteiro para um valor que indica o status da tabela. Um dos seguintes valores pode ser retornado:
TBLSTAT_COMPLETE
Nenhuma operação está em andamento.
TBLSTAT_QCHANGED
O conteúdo da tabela foi alterado com expectativa. Esse valor status não é retornado para alterações resultantes de operações de classificação ou restrição.
TBLSTAT_RESTRICT_ERROR
Ocorreu um erro durante uma operação IMAPITable::Restrict .
TBLSTAT_RESTRICTING
Uma operação IMAPITable::Restrict está em andamento.
TBLSTAT_SETCOL_ERROR
Ocorreu um erro durante uma operação IMAPITable::SetColumns .
TBLSTAT_SETTING_COLS
Uma operação IMAPITable::SetColumns está em andamento.
TBLSTAT_SORT_ERROR
Ocorreu um erro durante uma operação IMAPITable::SortTable .
TBLSTAT_SORTING
Uma operação IMAPITable::SortTable está em andamento.
lpulTableType
[out] Ponteiro para um valor que indica o tipo da tabela. Um dos três tipos de tabela a seguir pode ser retornado:
TBLTYPE_DYNAMIC
O conteúdo da tabela é dinâmico; as linhas e os valores de coluna podem ser alterados conforme os dados subjacentes são alterados.
TBLTYPE_KEYSET
As linhas dentro da tabela são fixas, mas os valores das colunas dentro dessas linhas são dinâmicos e podem ser alterados conforme os dados subjacentes são alterados.
TBLTYPE_SNAPSHOT
A tabela é estática e seu conteúdo não é alterado quando os dados subjacentes são alterados.
Valor de retorno
S_OK
O status da tabela foi retornado com êxito.
Comentários
O método IMAPTable::GetStatus recupera informações sobre o tipo e o status atual de uma tabela.
Notas para chamadores
Você pode usar o GetStatus em conjunto com outros três métodos IMAPITable para monitorar o status dessas operações e determinar o efeito na tabela. Chame GetStatus depois de fazer uma das seguintes chamadas IMAPITable :
IMAPITable::Restrição para definir uma restrição.
IMAPITable::SortTable para estabelecer uma ordem de classificação.
IMAPITable::SetColumns para definir um conjunto de colunas.
Referência do MFCMAPI
Para ver códigos de exemplo do MFCMAPI, confira a tabela a seguir.
| Arquivo | Função | Comentário |
|---|---|---|
| ContentsTableListCtrl.cpp |
CContentsTableListCtrl::GetStatus |
O MFCMAPI usa o método IMAPITable::GetStatus para relatar o status de uma tabela. |