IMAPIFormMgr::CalcFormPropSet
Gilt für: Outlook 2013 | Outlook 2016
Gibt ein Array der Eigenschaften zurück, die von einer Gruppe von Formularen verwendet werden.
HRESULT CalcFormPropSet(
LPSMAPIFORMINFOARRAY pfrminfoarray,
ULONG ulFlags,
LPMAPIFORMPROPARRAY FAR * ppResults
);
Parameter
pfrminfoarray
[in] Ein Zeiger auf ein Array von Formularinformationsobjekten, die die Formulare identifizieren, für die Eigenschaften zurückgegeben werden sollen.
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 Eigenschaften des Formulars.
FORMPROPSET_UNION
Das zurückgegebene Array enthält die Vereinigung der Eigenschaften des Formulars.
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 , die die von den Formularen verwendeten Eigenschaften enthält.
Rückgabewert
S_OK
Der Aufruf war erfolgreich und hat den erwarteten Wert oder die erwarteten Werte zurückgegeben.
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
Formular-Viewer rufen die IMAPIFormMgr::CalcFormPropSet-Methode auf, um ein Array der Eigenschaften abzurufen, die von einer Gruppe von Formularen verwendet werden. CalcFormPropSet akzeptiert abhängig vom im ulFlags-Parameter festgelegten Flag entweder eine Schnittmenge oder eine Vereinigung der Eigenschaftensätze dieser Formulare und gibt eine SMAPIFormPropArray-Struktur zurück, die die resultierende Gruppe von Eigenschaften enthält.
Hinweise für Implementierer
Wenn ein Formular-Viewer das MAPI_UNICODE-Flag im ulFlags-Parameter übergibt, sollten alle Zeichenfolgen als Unicode-Zeichenfolgen zurückgegeben werden. Formularbibliotheksanbieter, die unicode-Zeichenfolgen nicht unterstützen, sollten MAPI_E_BAD_CHARWIDTH zurückgeben, wenn MAPI_UNICODE übergeben wird.