IMAPIProp::DeleteProps
Gilt für: Outlook 2013 | Outlook 2016
Löscht eine oder mehrere Eigenschaften aus einem -Objekt.
HRESULT DeleteProps(
LPSPropTagArray lpPropTagArray,
LPSPropProblemArray FAR * lppProblems
);
Parameter
lpPropTagArray
[in] Ein Zeiger auf ein Array von Eigenschaftstags, die die zu löschenden Eigenschaften angeben. Der cValues-Member der SPropTagArray-Struktur , auf die von lpPropTagArray verwiesen wird, darf nicht null sein, und der lpPropTagArray-Parameter selbst darf nicht NULL sein.
lppProblems
[in, out] Bei der Eingabe ein Zeiger auf einen Zeiger auf eine SPropProblemArray-Struktur ; andernfalls NULL, was angibt, dass keine Fehlerinformationen erforderlich sind. Wenn lppProblems ein gültiger Zeiger für die Eingabe ist, gibt DeleteProps ausführliche Informationen zu Fehlern beim Löschen einer oder mehrerer Eigenschaften zurück.
Rückgabewert
S_OK
Eigenschaften wurden erfolgreich gelöscht.
MAPI_E_NO_ACCESS
Der Aufrufer verfügt über unzureichende Berechtigungen zum Löschen von Eigenschaften.
Hinweise
Die IMAPIProp::D eleteProps-Methode entfernt eine oder mehrere Eigenschaften aus dem aktuellen Objekt.
Hinweise für Implementierer
Sie müssen nicht zulassen, dass Eigenschaften aus allen Objekten gelöscht werden. Wenn das Objekt nicht änderbar ist, geben Sie MAPI_E_NO_ACCESS von der DeleteProps-Methode zurück.
Hinweise für Aufrufer
Sie müssen nicht den Eigenschaftentyp für jedes Eigenschaftstag im Eigenschaftentagarray festlegen, auf das der lpPropTagArray-Parameter verweist. Eigenschaftstypen werden ignoriert. nur die Eigenschaftenbezeichner werden verwendet.
Beachten Sie, dass einige Objekte keine Änderungen zulassen und dass diese Objekte MAPI_E_NO_ACCESS von der DeleteProps-Methode zurückgeben. Bei anderen Objekten können einige Eigenschaften gelöscht werden, andere jedoch nicht. Wenn beim Löschen nur einiger Eigenschaften ein Problem auftritt, gibt DeleteProps S_OK zurück. Wenn Sie einen gültigen Zeiger im lppProblems-Parameter übergeben haben, legt DeleteProps den Zeiger auf eine SPropProblemArray-Struktur fest, die detaillierte Informationen zu den Problemen mit den einzelnen Eigenschaften enthält. Wenn Sie beispielsweise alle Eigenschaften einer Nachricht löschen und ein Problem mit einer oder mehreren anlagen vorliegt, enthält die SPropProblemArray-Struktur einen Eintrag für die eigenschaft PR_MESSAGE_ATTACHMENTS (PidTagMessageAttachments).
Die Struktur, auf die von lppProblems verwiesen wird, ist nur gültig, wenn DeleteProps S_OK zurückgibt. Wenn DeleteProps einen Fehler zurückgibt, versuchen Sie nicht, die SPropProblemArray-Struktur zu verwenden. Rufen Sie stattdessen die IMAPIProp::GetLastError-Methode des Objekts auf, um weitere Informationen zum Fehler zu erhalten.
Geben Sie die zurückgegebene SPropProblemArray-Struktur frei, indem Sie die MAPIFreeBuffer-Funktion aufrufen.
MFCMAPI-Referenz
Einen MFCMAP-Beispielcode finden Sie in der folgenden Tabelle.
| Datei | Funktion | Kommentar |
|---|---|---|
| MAPIFunctions.cpp |
DeleteProperty |
MFCMAPI verwendet die IMAPIProp::D eleteProps-Methode , um eine Eigenschaft aus einem Objekt zu löschen. |