IMAPISession::GetStatusTable
Aplica-se a: Outlook 2013 | Outlook 2016
Fornece acesso à tabela status, uma tabela que contém informações sobre todos os recursos MAPI na sessão.
HRESULT GetStatusTable(
ULONG ulFlags,
LPMAPITABLE FAR * lppTable
);
Parâmetros
ulFlags
[in] Um bitmask de sinalizadores que determina o formato para colunas que são cadeias de caracteres. O seguinte sinalizador pode ser definido:
MAPI_UNICODE
As colunas de cadeia de caracteres estão no formato Unicode. Se o sinalizador MAPI_UNICODE não estiver definido, as colunas de cadeia de caracteres estarão no formato ANSI.
lppTable
[out] Um ponteiro para um ponteiro para a tabela status.
Valor de retorno
S_OK
A tabela foi retornada com êxito.
Comentários
O método IMAPISession::GetStatusTable fornece acesso à tabela status que contém informações sobre todos os recursos MAPI na sessão. Há uma linha na tabela para obter informações sobre o subsistema MAPI, uma linha para o spooler MAPI, uma linha para o catálogo de endereços integrado e uma linha para cada provedor de serviços no perfil.
Para obter uma lista completa de colunas necessárias e opcionais na tabela status, consulte Tabelas de Status.
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 |
|---|---|---|
| MainDlg.cpp |
CMainDlg::OnStatusTable |
O MFCMAPI usa o método IMAPISession::GetStatusTable para obter a tabela status a ser renderizada. |