ITnef::SetProps
Gilt für: Outlook 2013 | Outlook 2016
Legt den Wert einer oder mehrerer Eigenschaften für eine gekapselte Nachricht oder Anlage fest, ohne die ursprüngliche Nachricht oder Anlage zu ändern.
HRESULT SetProps(
ULONG ulFlags,
ULONG ulElemID,
ULONG cValues,
LPSPropValue lpProps
);
Parameter
ulFlags
[in] Eine Bitmaske von Flags, die steuert, wie Eigenschaftswerte festgelegt werden. Das folgende Flag kann festgelegt werden:
TNEF_PROP_CONTAINED
Codiert nur Eigenschaften aus der Nachricht oder Anlage, die durch den ulElemID-Parameter angegeben wird.
ulElemID
[in] Die PR_ATTACH_NUM (PidTagAttachNumber)-Eigenschaft einer Anlage, die eine Zahl enthält, die die Anlage in der übergeordneten Nachricht eindeutig identifiziert.
cValues
[in] Die Anzahl der Eigenschaftswerte in der SPropValue-Struktur , auf die der lpProps-Parameter verweist.
lpProps
[in] Ein Zeiger auf eine SPropValue-Struktur , die die Eigenschaftswerte der festzulegenden Eigenschaften enthält.
Rückgabewert
S_OK
Der Aufruf war erfolgreich und hat den erwarteten Wert oder die erwarteten Werte zurückgegeben.
Hinweise
Transportanbieter, Nachrichtenspeicheranbieter und Gateways rufen die ITnef::SetProps-Methode auf, um Eigenschaften festzulegen, die in die Kapselung einer Nachricht oder anlage einbezogen werden sollen, ohne die ursprüngliche Nachricht oder Anlage zu ändern. Alle Eigenschaften, die mit diesem Aufruf festgelegt werden, setzen vorhandene Eigenschaften in der gekapselten Nachricht außer Kraft.
SetProps wird nur für TNEF-Objekte unterstützt, die mit dem TNEF_ENCODE-Flag für die OpenTnefStream - oder OpenTnefStreamEx-Funktion geöffnet werden. Mit diesem Aufruf kann eine beliebige Anzahl von Eigenschaften festgelegt werden.
Hinweis
Die tatsächliche TNEF-Codierung für SetProps erfolgt erst nach dem Aufruf der ITnef::Finish-Methode . Diese Funktionalität bedeutet, dass an SetProps übergebene Zeiger gültig bleiben müssen, bis der Aufruf von Finish erfolgt ist. An diesem Punkt können alle Objekte und Daten, die an SetProps-Aufrufe übergeben werden, freigegeben oder freigegeben werden.