IMAPIFormMgr::CalcFormPropSet
Aplica-se a: Outlook 2013 | Outlook 2016
Retorna uma matriz das propriedades que um grupo de formulários usa.
HRESULT CalcFormPropSet(
LPSMAPIFORMINFOARRAY pfrminfoarray,
ULONG ulFlags,
LPMAPIFORMPROPARRAY FAR * ppResults
);
Parâmetros
pfrminfoarray
[in] Um ponteiro para uma matriz de objetos de informações de formulário que identificam os formulários para os quais retornar propriedades.
ulFlags
[in] Um bitmask de sinalizadores que controla como a matriz de propriedades no parâmetro ppResults é retornada. Os seguintes sinalizadores podem ser definidos:
FORMPROPSET_INTERSECTION
A matriz retornada contém a interseção das propriedades do formulário.
FORMPROPSET_UNION
A matriz retornada contém a união das propriedades do formulário.
MAPI_UNICODE
As cadeias de caracteres retornadas na matriz estão no formato Unicode. Se o sinalizador MAPI_UNICODE não estiver definido, as cadeias de caracteres estarão no formato ANSI.
ppResults
[out] Um ponteiro para um ponteiro para a estrutura SMAPIFormPropArray retornada, que contém as propriedades que os formulários usam.
Valor de retorno
S_OK
A chamada foi bem-sucedida e retornou o valor ou valores esperados.
MAPI_E_BAD_CHARWIDTH
O sinalizador MAPI_UNICODE foi definido e a implementação não dá suporte ao Unicode ou MAPI_UNICODE não foi definido e a implementação dá suporte apenas ao Unicode.
Comentários
Os visualizadores de formulário chamam o método IMAPIFormMgr::CalcFormPropSet para obter uma matriz das propriedades que um grupo de formulários usa. CalcFormPropSet usa uma interseção ou uma união dos conjuntos de propriedades desses formulários, dependendo do conjunto de sinalizadores no parâmetro ulFlags , e retorna uma estrutura SMAPIFormPropArray que contém o grupo resultante de propriedades.
Observações para implementadores
Se um visualizador de formulários passar o sinalizador MAPI_UNICODE no parâmetro ulFlags , todas as cadeias de caracteres deverão ser retornadas como cadeias de caracteres Unicode. Os provedores de biblioteca de formulários que não dão suporte a cadeias de caracteres Unicode devem retornar MAPI_E_BAD_CHARWIDTH se MAPI_UNICODE for aprovada.