IMAPIFormContainer::CalcFormPropSet
Aplica-se a: Outlook 2013 | Outlook 2016
Retorna uma matriz das propriedades usadas por todos os formulários instalados em um contêiner de formulário.
HRESULT CalcFormPropSet(
ULONG ulFlags,
LPMAPIFORMPROPARRAY FAR * ppResults
);
Parâmetros
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 dos formulários.
FORMPROPSET_UNION
A matriz retornada contém a união das propriedades dos formulários.
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. Essa estrutura contém todas as propriedades usadas pelos formulários instalados.
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 aplicativos cliente chamam o método IMAPIFormContainer::CalcFormPropSet para obter uma matriz de propriedades usadas por todos os formulários instalados em um contêiner de formulário. IMAPIFormContainer::CalcFormPropSet funciona como o método IMAPIFormMgr::CalcFormPropSet , exceto que ele opera em todos os formulários registrados em um contêiner específico.
Observações para implementadores
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.
Notas para chamadores
IMAPIFormContainer::CalcFormPropSet usa uma interseção ou uma união dos conjuntos de propriedades dos formulários, dependendo do sinalizador definido no parâmetro ulFlags , e retorna uma estrutura SMAPIFormPropArray que contém o grupo resultante de propriedades.
Se um cliente passar o sinalizador MAPI_UNICODE em ulFlags, todas as cadeias de caracteres retornadas serão Unicode.