ITnef::AddProps

Gilt für: Outlook 2013 | Outlook 2016

Ermöglicht dem aufrufenden Dienstanbieter oder Gateway, der Kapselung einer Nachricht oder eines Anhangs 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 Parameter ulElemID angegeben werden. Wenn der Parameter lpvData nicht NULL ist, werden die Daten, auf die verwiesen wird, in die Kapselung der Anlage in der Datei geschrieben, die durch die Eigenschaft PR_ATTACH_TRANSPORT_NAME (PidTagAttachTransportName) angegeben wird.

TNEF_PROP_CONTAINED_TNEF

Codiert nur Eigenschaften aus der Nachricht oder Anlage, die durch den Parameter ulElemID 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 Parameter lpPropList angegeben sind.

TNEF_PROP_INCLUDE

Codiert alle Eigenschaften, die in lpPropListangegeben sind.

TNEF_PROP_MESSAGE_ONLY

Codiert nur die Eigenschaften, die in lpPropList angegeben sind, 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 muss 0 sein, es sei denn, das Flag TNEF_PROP_CONTAINED oder TNEF_PROP_CONTAINED_TNEF wird im Parameter ulFlags festgelegt.

lpvData

[in] Ein Zeiger auf Anlagendaten, der verwendet wird, um die Daten der Anlage zu ersetzen, die in ulElemID angegeben ist. Der Parameter lpvData muss NULL sein, es sei denn, TNEF_PROP_CONTAINED oder TNEF_PROP_CONTAINED_TNEF wird in ulFlagsfestgelegt.

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 auflisten, die in die TNEF-Verarbeitung (Transport-Neutral Encapsulation Format) einer Nachricht oder Anlage eingeschlossen oder aus ihr ausgeschlossen werden sollen. Durch die Verwendung aufeinanderfolgender 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 auch verwenden, um Informationen zu etwaigen Sonderbehandlungsanhängen bereitzustellen.

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 Zeiger, die an AddProps übergeben werden, bis nach dem Aufruf von Finish gültig bleiben müssen. An diesem Punkt können alle Objekte und Daten, die mit AddProps-Aufrufen übergeben werden, freigegeben werden.

MFCMAPI-Referenz

Einen MFCMAP-Beispielcode finden Sie in der folgenden Tabelle.

Siehe auch

ITnef::Finish

OpenTnefStream

OpenTnefStreamEx

Canonical Eigenschaft „PidTagAttachTransportName“

ITnef : IUnknown

MFCMAPI (engl.) als ein Codebeispiel