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
[in] Uma máscara de bits de sinalizadores que controla a forma como a tabela de perfis é preenchida. Pode definir o seguinte sinalizador:
MAPI_APP_PROFILE
Inclua perfis de "aplicação" na tabela de perfis. Se este sinalizador não estiver definido, os perfis de "aplicação" não serão incluídos.
Este sinalizador pode não ser reconhecido ou suportado 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 perfis foi obtida com êxito.
Comentários
O método IProfAdmin::GetProfileTable fornece acesso à tabela de perfil, que contém uma linha para cada perfil disponível. Existem apenas duas colunas em cada linha: o nome a apresentar do perfil e um sinalizador que indica se o perfil é a predefinição.
Os perfis que foram eliminados ou que estão a ser utilizados, mas que foram marcados para eliminação, não estão incluídos na tabela de perfis. A tabela de perfil é estática; as adições e eliminações subsequentes de perfis não são refletidas na tabela.
Se não existirem perfis, GetProfileTable devolve uma tabela com zero linhas.
Para obter mais informações sobre a tabela de perfis, veja 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 utiliza o método IProfAdmin::GetProfileTable para que a tabela de perfil seja apresentada numa nova caixa de diálogo. |