IMAPIFormContainer::ResolveMultipleMessageClasses
Aplica-se a: Outlook 2013 | Outlook 2016
Resolve um grupo de classes de mensagem para seus formulários em um contêiner de formulário e retorna uma matriz de objetos de informações de formulário para esses formulários.
HRESULT ResolveMultipleMessageClasses(
LPSMESSAGECLASSARRAY pMsgClassArray,
ULONG ulFlags,
LPSMAPIFORMINFOARRAY FAR * ppfrminfoarray
);
Parâmetros
pMsgClassArray
[in] Um ponteiro para uma matriz que contém os nomes das classes de mensagem a resolve. Nomes de classe de mensagem são sempre cadeias de caracteres ANSI, nunca Unicode.
ulFlags
[in] Um bitmask de sinalizadores que controla como as classes de mensagem são resolvidas. 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.
ppfrminfoarray
[out] Um ponteiro para um ponteiro para uma matriz de objetos de informações de formulário. Se um aplicativo cliente passar NULL no parâmetro pMsgClassArray , o parâmetro ppfrminfoarray contém objetos de informações de formulário para todos os formulários no contêiner.
Valor de retorno
S_OK
A chamada foi bem-sucedida e retornou o valor ou valores esperados.
Comentários
Os aplicativos cliente chamam o método IMAPIFormContainer::ResolveMultipleMessageClasses para resolve um grupo de classes de mensagens para formulários em um contêiner de formulário. A matriz de objetos de informações de formulário retornados no parâmetro ppfrminfoarray fornece acesso adicional a cada uma das propriedades dos formulários.
Notas para chamadores
Para resolve um grupo de classes de mensagens para formulários, passe uma matriz de nomes de classe de mensagem a ser resolvida. 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 .
Se uma classe de mensagem não puder ser resolvida em um formulário, NULL será retornado para essa classe de mensagem na matriz de informações do formulário. Portanto, mesmo que o método retorne S_OK, não suponha que todas as classes de mensagem tenham sido resolvidas com êxito. Em vez disso, marcar os valores na matriz retornada.
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::OnResolveMultipleMessageClasses |
O MFCMAPI usa o método IMAPIFormContainer::ResolveMultipleMessageClasses para localizar um formulário associado a um conjunto de classes de mensagem. |