IMAPIFormMgr::OpenFormContainer
Aplica-se a: Outlook 2013 | Outlook 2016
Abre uma interface IMAPIFormContainer para um contêiner de formulário específico.
HRESULT OpenFormContainer(
HFRMREG hfrmreg,
LPUNKNOWN lpunk,
LPMAPIFORMCONTAINER FAR * lppfcnt
);
Parâmetros
hfrmreg
[in] Uma enumeração HFRMREG que indica a biblioteca de formulários a ser aberta (ou seja, o contêiner de formulário a ser aberto). Uma enumeração HFRMREG é uma enumeração específica para um provedor de biblioteca de formulários. Os valores de HFRMREG possíveis incluem o seguinte:
HFRMREG_DEFAULT
Um contêiner de formulário conveniente.
HFRMREG_FOLDER
Um contêiner de pasta.
HFRMREG_PERSONAL
O contêiner para o repositório de mensagens padrão.
HFRMREG_LOCAL
Um contêiner de formulário local.
lpunk
[in] Um ponteiro para o objeto para o qual a interface é aberta. O parâmetro lpunk deve ser nulo , a menos que o valor do parâmetro hfrmreg exija um ponteiro de objeto.
lppfcnt
[out] Um ponteiro para um ponteiro para o objeto de contêiner de formulário retornado.
Valor de retorno
S_OK
A chamada foi bem-sucedida e retornou o valor ou valores esperados.
MAPI_E_NO_INTERFACE
O objeto apontado por lpunk não dá suporte à interface necessária.
Comentários
Os visualizadores de formulário chamam o método IMAPIFormMgr::OpenFormContainer para abrir uma interface IMAPIFormContainer para um contêiner de formulário específico. Essa interface pode então ser usada para instalar formulários e remover formulários de um contêiner de formulário.
Notas para chamadores
Se o valor em hfrmreg for HFRMREG_FOLDER, o identificador de interface usado no lpunk deve ser não nulo e deve permitir chamadas de método IUnknown::QueryInterface para uma interface IMAPIFolder .
Para abrir o contêiner de formulário local, você deve usar uma chamada para o método OpenFormContainer ou a função MAPIOpenLocalFormContainer ; você não pode usar o método IMAPIFormMgr::SelectFormContainer para permitir que o usuário selecione o contêiner de formulário 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::OnOpenFormContainer |
O MFCMAPI usa o método IMAPIFormMgr::OpenFormContainer para recuperar um contêiner de formulário para que o conteúdo do contêiner possa ser renderizado. |
| MsgStoreDlg.cpp |
CMsgStoreDlg::OnOpenFormContainer |
O MFCMAPI usa o método IMAPIFormMgr::OpenFormContainer para recuperar um contêiner de formulário para uma pasta para que o conteúdo do contêiner possa ser renderizado. |
Confira também
IMAPIFormContainer::InstallForm