ITnef::AddProps

Artikel
04/04/2023

Gilt für: Outlook 2013 | Outlook 2016

Ermöglicht dem aufrufenden Dienstanbieter oder Gateway, der Kapselung einer Nachricht oder anlage Eigenschaften hinzuzufügen.

HRESULT AddProps(
  ULONG ulFlags,
  ULONG ulElemID,
  LPVOID lpvData,
  LPSPropTagArray lpPropList
);

Parameter

ulFlags

[in] Eine Bitmaske von Flags, die steuert, wie Eigenschaften in die Kapselung eingeschlossen oder davon ausgeschlossen werden. Die folgenden Flags können festgelegt werden:

TNEF_PROP_ATTACHMENTS_ONLY

Codiert nur die Eigenschaften im lpPropList-Parameter , die Teil von Anlagen in der Nachricht sind.

TNEF_PROP_CONTAINED

Codiert nur Eigenschaften aus der Anlage, die durch den ulElemID-Parameter angegeben wird. Wenn der lpvData-Parameter nicht NULL ist, werden die Daten, auf die verwiesen wird, in die Kapselung der Anlage in die Datei geschrieben, die durch die PR_ATTACH_TRANSPORT_NAME -Eigenschaft (PidTagAttachTransportName) angegeben wird.

TNEF_PROP_CONTAINED_TNEF

Codiert nur Eigenschaften aus der Nachricht oder Anlage, die durch den ulElemID-Parameter angegeben wird. Wenn dieses Flag festgelegt ist, muss der Wert in lpvData ein IStream-Zeiger sein.

TNEF_PROP_EXCLUDE

Codiert alle Eigenschaften, die nicht im lpPropList-Parameter angegeben sind.

TNEF_PROP_INCLUDE

Codiert alle in lpPropList angegebenen Eigenschaften.

TNEF_PROP_MESSAGE_ONLY

Codiert nur die in lpPropList angegebenen Eigenschaften, die Teil der Nachricht selbst sind.

ulElemID

[in] Die PR_ATTACH_NUM (PidTagAttachNumber)-Eigenschaft einer Anlage, die eine Zahl enthält, die die Anlage in der übergeordneten Nachricht eindeutig identifiziert. Der ulElemID-Parameter wird verwendet, wenn eine spezielle Behandlung für eine Anlage angefordert wird. Der ulElemID-Parameter sollte 0 sein, es sei denn, das TNEF_PROP_CONTAINED- oder TNEF_PROP_CONTAINED_TNEF-Flag ist im ulFlags-Parameter festgelegt.

lpvData

[in] Ein Zeiger auf Anlagendaten, die verwendet werden, um die Daten der in ulElemID angegebenen Anlage zu ersetzen. Der lpvData-Parameter sollte NULL sein, es sei denn, TNEF_PROP_CONTAINED oder TNEF_PROP_CONTAINED_TNEF ist in ulFlags festgelegt.

lpPropList

[in] Ein Zeiger auf die Liste der Eigenschaften, die in die Kapselung eingeschlossen oder von der Kapselung ausgeschlossen werden sollen.

Rückgabewert

S_OK

Der Aufruf erfolgreich ausgef�hrt und der erwartete Wert oder Werte zur�ckgegeben hat.

Hinweise

Transportanbieter, Nachrichtenspeicheranbieter und Gateways rufen die ITnef::AddProps-Methode auf, um Eigenschaften aufzulisten, die in die TNEF-Verarbeitung (Transport-Neutral Encapsulation Format) einer Nachricht oder einer Anlage eingeschlossen oder davon ausgeschlossen werden sollen. Durch die Verwendung aufeinander folgender Aufrufe kann der Anbieter oder das Gateway eine Liste von Eigenschaften angeben, die hinzugefügt und codiert oder von der Codierung ausgeschlossen werden sollen. Anbieter und Gateways können auch AddProps verwenden, um Informationen zu speziellen Verarbeitungsanlagen bereitzustellen, die angegeben werden sollten.

AddProps wird nur für TNEF-Objekte unterstützt, die mit dem TNEF_ENCODE-Flag für die OpenTnefStream - oder OpenTnefStreamEx-Funktion geöffnet werden.

Beachten Sie, dass keine tatsächliche TNEF-Codierung für AddProps erfolgt, bis die ITnef::Finish-Methode aufgerufen wird. Diese Funktionalität bedeutet, dass an AddProps übergebene Zeiger gültig bleiben müssen, bis der Aufruf von Finish erfolgt ist. An diesem Punkt können alle Objekte und Daten, die mit AddProps-Aufrufen übergeben werden, freigegeben oder freigegeben werden.