IMAPIFormMgr::SelectFormContainer
Aplica-se a: Outlook 2013 | Outlook 2016
Apresenta uma caixa de diálogo que permite que o usuário selecione um contêiner de formulários e retorna uma interface para o objeto de contêiner selecionado pelo usuário.
HRESULT SelectFormContainer(
ULONG_PTR ulUIParam,
ULONG ulFlags,
LPMAPIFORMCONTAINER FAR * lppfcnt
);
Parâmetros
ulUIParam
[in] Um identificador para a janela pai da caixa de diálogo exibida.
ulFlags
[in] Um bitmask de sinalizadores que controla como a biblioteca de formulários é selecionada (ou seja, como o contêiner de formulários é selecionado). Os seguintes sinalizadores podem ser definidos:
MAPIFORM_SELECT_ALL_REGISTRIES
A seleção pode ser feita de todos os contêineres. Esse é o tipo de seleção padrão.
MAPIFORM_SELECT_FOLDER_REGISTRY_ONLY
A seleção só pode ser feita em contêineres de pastas.
MAPIFORM_SELECT_NON_FOLDER_REGISTRY_ONLY
A seleção só pode ser feita em contêineres que não estão associados a pastas.
lppfcnt
[out] Um ponteiro para um ponteiro para a interface retornada. Essa interface é para o objeto de contêiner selecionado pelo usuário.
Valor de retorno
S_OK
A chamada foi bem-sucedida e retornou o valor ou valores esperados.
Comentários
Os visualizadores de formulário normalmente chamam o método IMAPIFormMgr::SelectFormContainer para selecionar um contêiner de formulário no qual um formulário está instalado. SelectFormContainer não pode ser usado para selecionar o contêiner de formulário local, que tem o valor HFRMREG_LOCAL.
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::OnSelectFormContainer |
O MFCMAPI usa o método IMAPIFormMgr::SelectFormContainer para selecionar um contêiner de formulários antes de renderizar seu conteúdo. |