IProfAdmin::GetProfileTable

Aplica-se a: Outlook 2013 | Outlook 2016

Fornece acesso à tabela de perfil, uma tabela que contém informações sobre todos os perfis disponíveis.

HRESULT GetProfileTable(
  ULONG ulFlags,
  LPMAPITABLE FAR * lppTable
);

Parâmetros

ulFlags

[em] Uma máscara de bits de sinalizadores que controla como a tabela de perfil é preenchida. O seguinte sinalizador pode ser definido:

MAPI_APP_PROFILE

Inclua perfis de "aplicativo" na tabela de perfil. Se esse sinalizador não estiver definido, os perfis de "aplicativo" não serão incluídos.

Esse sinalizador pode não ser reconhecido ou não ter suporte em todas as implementações MAPI.

lppTable

[fora] Um ponteiro para um ponteiro para a tabela de perfil.

Valor de retorno

S_OK

A tabela de perfil foi recuperada com êxito.

Comentários

O método IProfAdmin::GetProfileTable fornece acesso à tabela de perfil, que contém uma linha para cada perfil disponível. Há apenas duas colunas em cada linha: o nome de exibição do perfil e um sinalizador que indica se o perfil é o padrão.

Os perfis que foram excluídos ou que estão em uso, mas foram marcados para exclusão, não são incluídos na tabela de perfis. A tabela de perfil é estática; adições e exclusões subsequentes de perfis não são refletidas na tabela.

Se não houver perfis, GetProfileTable retornará uma tabela com zero linhas.

Para obter mais informações sobre a tabela de perfil, consulte Tabelas de perfil.

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::OnShowProfiles
O MFCMAPI usa o método IProfAdmin::GetProfileTable para exibir a tabela de perfil em uma nova caixa de diálogo.

Confira também

IMAPITable : IUnknown

MAPILogonEx

IProfAdmin : IUnknown

MFCMAPI como exemplo de código