IMAPIProp::GetPropList

Gilt für: Outlook 2013 | Outlook 2016

Gibt Eigenschaftstags für alle Eigenschaften zurück.

HRESULT GetPropList(
  ULONG ulFlags,
  LPSPropTagArray FAR * lppPropTagArray
);

Parameter

ulFlags

[in] Eine Bitmaske von Flags, die das Format für die Zeichenfolgen in den zurückgegebenen Eigenschaftstags steuert. Das folgende Flag kann festgelegt werden:

MAPI_UNICODE

Die zurückgegebenen Zeichenfolgen liegen im Unicode-Format vor. Wenn das MAPI_UNICODE-Flag nicht festgelegt ist, liegen die Zeichenfolgen im ANSI-Format vor.

lppPropTagArray

[out] Ein Zeiger auf einen Zeiger auf das Eigenschaftentagarray, das Tags für alle Eigenschaften des Objekts enthält.

Rückgabewert

S_OK

Alle Eigenschaftstags wurden erfolgreich 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

Die IMAPIProp::GetPropList-Methode ruft das Eigenschaftstag für jede Eigenschaft ab, die derzeit von einem -Objekt unterstützt wird. Wenn das Objekt derzeit keine Eigenschaften unterstützt, gibt GetPropList ein Eigenschaftentagarray zurück, wobei der cValues-Member auf 0 festgelegt ist.

Der Bereich der von GetPropList zurückgegebenen Eigenschaften variiert von Anbieter zu Anbieter. Einige Dienstanbieter schließen die Eigenschaften aus, auf die der Aufrufer keinen Zugriff hat. Alle Anbieter geben Eigenschaften vom Typ PT_OBJECT zurück.

Wenn das Objekt Unicode nicht unterstützt, gibt GetPropList MAPI_E_BAD_CHARWIDTH zurück, auch wenn für das Objekt keine Zeichenfolgeneigenschaften definiert sind.

Hinweise für Implementierer

Remotetransportanbieter implementieren GetPropList genau wie hier angegeben. Es gibt keine besonderen Bedenken. Ihre Implementierung sollte natürlich dieselbe Liste von Eigenschaften zurückgeben, die von der IMAPIProp::GetProps-Methode unterstützt wird.

Hinweise für Aufrufer

Rufen Sie die MAPIFreeBuffer-Funktion auf, um das Eigenschaftentagarray frei zu geben, auf das lppPropTagArray verweist.

MFCMAPI-Referenz

Einen MFCMAP-Beispielcode finden Sie in der folgenden Tabelle.

Datei	Funktion	Kommentar
MAPIFunctions.cpp	GetPropsNULL	MFCMAPI verwendet die IMAPIProp::GetPropList-Methode , um eine Eigenschaftsliste abzurufen, die an GetProps übergeben werden soll.

Siehe auch

IMAPIProp::GetProps
MAPIFreeBuffer
IMAPIProp : IUnknownMFCMAPI als Codebeispiel