IMAPIFormMgr::ResolveMultipleMessageClasses
Aplica-se a: Outlook 2013 | Outlook 2016
Resolve um grupo de classes de mensagens para seus formulários dentro de 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 pMsgClasses,
ULONG ulFlags,
LPMAPIFOLDER pFolderFocus,
LPSMAPIFORMINFOARRAY FAR * ppfrminfoarray
);
Parâmetros
pMsgClasses
[in] Um ponteiro para uma matriz que contém os nomes das classes de mensagem a resolve.
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.
MAPIFORM_LOCALONLY
Não inclua formulários armazenados em cache.
pFolderFocus
[in] Um ponteiro para a pasta que contém o formulário cuja classe de mensagem está sendo resolvida. O parâmetro pFolderFocus pode ser NULL.
ppfrminfoarray
[out] Um ponteiro para um ponteiro para uma matriz de objetos de informações de formulário. Se um visualizador de formulários passar NULL no parâmetro pMsgClasses , o parâmetro ppfrminfoarray conterá 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 visualizadores de formulários chamam o método IMAPIFormMgr::ResolveMultipleMessageClasses para resolve um grupo de classes de mensagem para formulários em um contêiner de formulário. A matriz de objetos de informações de formulário retornados em 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, um visualizador de formulários passa uma matriz de nomes de classe de mensagem a ser resolvido. Para forçar a resolução a ser exata (ou seja, para impedir a resolução para uma classe base da classe de mensagem quando um servidor de formulário exatamente correspondente não estiver disponível), o sinalizador MAPIFORM_EXACTMATCH pode ser passado no parâmetro ulFlags .
Nomes de classe de mensagem são sempre cadeias de caracteres ANSI, nunca Unicode.
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, os visualizadores de formulário não devem trabalhar na suposição de que todas as classes de mensagem foram resolvidas com êxito. Em vez disso, os visualizadores de formulário devem marcar os valores na matriz retornada.