IMAPIFormMgr::CreateForm
Aplica-se a: Outlook 2013 | Outlook 2016
Abre um formulário para criar uma nova mensagem com base na classe de mensagem do formulário.
HRESULT CreateForm(
ULONG_PTR ulUIParam,
ULONG ulFlags,
IMAPIFormInfo pfrminfoToActivate,
REFIID refiidToAsk,
LPVOID FAR * ppvObj
);
Parâmetros
ulUIParam
[in] Um identificador para a janela pai para o indicador de progresso exibido enquanto o formulário é aberto. O parâmetro ulUIParam é ignorado, a menos que o sinalizador MAPI_DIALOG seja definido no parâmetro ulFlags .
ulFlags
[in] Um bitmask de sinalizadores que controla como o formulário é aberto. O seguinte sinalizador pode ser definido:
MAPI_DIALOG
Exibe uma interface do usuário para fornecer status ou solicitar ao usuário mais informações. Se esse sinalizador não estiver definido, nenhuma interface do usuário será exibida.
pfrminfoToActivate
[in] Um ponteiro para o objeto de informações do formulário que é usado para abrir o formulário.
refiidToAsk
[in] Um ponteiro para o IID (identificador de interface) para que a interface seja retornada para o objeto de formulário criado. O parâmetro refiidToAsk não deve ser NULL.
Ppvobj
[out] Um ponteiro para um ponteiro para a interface retornada.
Valor de retorno
S_OK
A chamada foi bem-sucedida e retornou o valor ou valores esperados.
MAPI_E_NO_INTERFACE
A interface solicitada não tem suporte para o objeto de formulário.
Comentários
Os espectadores de formulário chamam o método IMAPIFormMgr::CreateForm para abrir um formulário para criar uma nova mensagem com base na classe de mensagem do formulário. CreateForm abre o formulário criando uma instância do servidor de formulário para esse formulário, conforme descrito no objeto de informações de formulário fornecido. Se necessário, CreateForm chama o método IMAPIFormMgr::P repareForm para baixar o código do servidor de formulário no disco do usuário.
O parâmetro pfrminfoToActivate deve apontar para um objeto de informações de formulário que foi resolvido corretamente.
Depois que o formulário for aberto, o visualizador de formulário de chamada deve configurar uma mensagem usando a interface IPersistMessage e, opcionalmente, pode configurar um contexto de exibição para o formulário. Para obter mais informações, consulte Iniciar um Servidor de Formulários.
Referência do MFCMAPI
Para ver códigos de exemplo do MFCMAPI, confira a tabela a seguir.
| Arquivo | Função | Comentário |
|---|---|---|
| MAPIFormFunctions.cpp |
CreateAndDisplayNewMailInFolder |
O MFCMAPI usa o método IMAPIFormMgr::CreateForm para criar um formulário antes de exibi-lo. |