IMsgStore::GetReceiveFolderTable
Aplica-se a: Outlook 2013 | Outlook 2016
Fornece acesso à tabela de pastas de recebimento, uma tabela que inclui informações sobre todas as pastas de recebimento para o repositório de mensagens.
HRESULT GetReceiveFolderTable(
ULONG ulFlags,
LPMAPITABLE FAR * lppTable );
Parâmetros
ulFlags
[in] Um bitmask de sinalizadores que controla o acesso à tabela. Os seguintes sinalizadores podem ser definidos:
MAPI_DEFERRED_ERRORS
Permite que GetReceiveFolderTable retorne com êxito , possivelmente antes que a tabela esteja totalmente disponível para o chamador. Se a tabela não estiver totalmente disponível, fazer uma chamada de tabela subsequente poderá gerar um erro.
MAPI_UNICODE
As cadeias de caracteres retornadas estão no formato Unicode. Se o sinalizador MAPI_UNICODE não estiver definido, as cadeias de caracteres estarão no formato ANSI.
lppTable
[out] Um ponteiro para um ponteiro para a tabela de pastas de recebimento.
Valor de retorno
S_OK
A tabela de pastas de recebimento foi retornada com êxito.
Comentários
O método IMsgStore::GetReceiveFolderTable fornece acesso a uma tabela que mostra as configurações da propriedade para todas as pastas de recebimento do repositório de mensagens.
Observações para implementadores
Para obter uma lista de colunas necessárias em uma tabela de pastas de recebimento, consulte Receber Tabelas de Pastas.
Implemente suas tabelas de pastas de recebimento para dar suporte à configuração de restrições de propriedade na propriedade PR_RECORD_KEY (PidTagRecordKey). Isso permite acesso fácil a pastas de recebimento específicas.
Notas para chamadores
Definir o sinalizador MAPI_UNICODE no parâmetro ulFlags afeta o formato das colunas retornadas dos métodos IMAPITable::QueryColumns e IMAPITable::QueryRows . Esse sinalizador também controla os tipos de propriedade na ordem de classificação retornada pelo método IMAPITable::QuerySortOrder .
Referência do MFCMAPI
Para ver códigos de exemplo do MFCMAPI, confira a tabela a seguir.
| Arquivo | Função | Comentário |
|---|---|---|
| MsgStoreDlg.cpp |
CMsgStoreDlg::OnDisplayReceiveFolderTable |
O MFCMAPI usa o método IMsgStore::GetReceiveFolderTable para obter a tabela de pastas de recebimento a ser exibida. |