IMAPIFormContainer::ResolveMessageClass
Aplica-se a: Outlook 2013 | Outlook 2016
Resolve uma classe de mensagem para seu formulário em um contêiner de formulário e retorna um objeto de informações de formulário para esse formulário.
HRESULT ResolveMessageClass(
LPCSTR szMessageClass,
ULONG ulFlags,
LPMAPIFORMINFO FAR * ppforminfo
);
Parâmetros
szMessageClass
[in] Uma cadeia de caracteres que nomeia a classe de mensagem que está sendo resolvida. Nomes de classe de mensagem são sempre cadeias de caracteres ANSI, nunca Unicode.
ulFlags
[in] Um bitmask de sinalizadores que controla como a classe de mensagem é resolvida. O seguinte sinalizador pode ser definido:
MAPIFORM_EXACTMATCH
Somente cadeias de caracteres de classe de mensagem que são uma correspondência exata devem ser resolvidas.
ppforminfo
[out] Um ponteiro para um ponteiro para o objeto de informações de formulário retornado.
Valor de retorno
S_OK
A chamada foi bem-sucedida e retornou o valor ou valores esperados.
MAPI_E_NOT_FOUND
A classe de mensagem passada no parâmetro szMessageClass não corresponde à classe de mensagem para qualquer formulário no contêiner de formulário.
Comentários
Os aplicativos cliente chamam o método IMAPIFormContainer::ResolveMessageClass para resolve uma classe de mensagem para um formulário dentro de um contêiner de formulário. O objeto de informações de formulário retornado no parâmetro ppforminfo fornece acesso adicional às propriedades do formulário com a classe de mensagem fornecida.
Notas para chamadores
Para resolve uma classe de mensagem para um formulário, passe o nome da classe de mensagem a ser resolvido (por exemplo, IPM.HelpDesk.Software). Para forçar a resolução a ser exata (ou seja, para impedir a resolução para uma classe base da classe de mensagem), o sinalizador MAPIFORM_EXACTMATCH pode ser passado no parâmetro ulFlags .
O identificador de classe da classe de mensagem resolvida é retornado como parte do objeto de informações do formulário. Não suponha que o identificador de classe exista na biblioteca OLE até que você chame o método IMAPIFormMgr::P repareForm ou IMAPIFormMgr::CreateForm .
Referência do MFCMAPI
Para ver códigos de exemplo do MFCMAPI, confira a tabela a seguir.
| Arquivo | Função | Comentário |
|---|---|---|
| FormContainerDlg.cpp |
CFormContainerDlg::OnResolveMessageClass |
O MFCMAPI usa o método IMAPIFormContainer::ResolveMessageClass para localizar um formulário associado a uma classe de mensagem. |