IMAPIFormContainer::CalcFormPropSet
Gilt für: Outlook 2013 | Outlook 2016
Gibt ein Array der Eigenschaften zurück, die von allen Formularen verwendet werden, die in einem Formularcontainer installiert sind.
HRESULT CalcFormPropSet(
ULONG ulFlags,
LPMAPIFORMPROPARRAY FAR * ppResults
);
Parameter
ulFlags
[in] Eine Bitmaske von Flags, die steuert, wie das Eigenschaftenarray im ppResults-Parameter zurückgegeben wird. Die folgenden Flags können festgelegt werden:
FORMPROPSET_INTERSECTION
Das zurückgegebene Array enthält die Schnittmenge der Formulareigenschaften.
FORMPROPSET_UNION
Das zurückgegebene Array enthält die Vereinigung der Formulareigenschaften.
MAPI_UNICODE
Die im Array zurückgegebenen Zeichenfolgen weisen das Unicode-Format auf. Wenn das MAPI_UNICODE-Flag nicht festgelegt ist, liegen die Zeichenfolgen im ANSI-Format vor.
ppResults
[out] Ein Zeiger auf einen Zeiger auf die zurückgegebene SMAPIFormPropArray-Struktur . Diese Struktur enthält alle Eigenschaften, die von den installierten Formularen verwendet werden.
Rückgabewert
S_OK
Der Aufruf erfolgreich ausgef�hrt und der erwartete Wert oder Werte zur�ckgegeben hat.
MAPI_E_BAD_CHARWIDTH
Entweder wurde das flag MAPI_UNICODE festgelegt, und die Implementierung unterstützt Unicode nicht, oder MAPI_UNICODE wurde nicht festgelegt und die Implementierung unterstützt nur Unicode.
Hinweise
Clientanwendungen rufen die IMAPIFormContainer::CalcFormPropSet-Methode auf, um ein Array von Eigenschaften abzurufen, die von allen in einem Formularcontainer installierten Formularen verwendet werden. IMAPIFormContainer::CalcFormPropSet funktioniert wie die IMAPIFormMgr::CalcFormPropSet-Methode , mit der Ausnahme, dass sie für jedes Formular verwendet wird, das in einem bestimmten Container registriert ist.
Hinweise für Implementierer
Formularbibliotheksanbieter, die unicode-Zeichenfolgen nicht unterstützen, sollten MAPI_E_BAD_CHARWIDTH zurückgeben, wenn MAPI_UNICODE übergeben wird.
Hinweise für Aufrufer
IMAPIFormContainer::CalcFormPropSet akzeptiert abhängig vom im ulFlags-Parameter festgelegten Flag entweder eine Schnittmenge oder eine Vereinigung der Eigenschaftensätze der Formulare und gibt eine SMAPIFormPropArray-Struktur zurück, die die resultierende Gruppe von Eigenschaften enthält.
Wenn ein Client das MAPI_UNICODE-Flag in ulFlags übergibt, sind alle zurückgegebenen Zeichenfolgen Unicode.