IPropData::HrAddObjProps
Gilt für: Outlook 2013 | Outlook 2016
Fügt dem Objekt eine oder mehrere Eigenschaften vom Typ PT_OBJECT hinzu.
HRESULT HrAddObjProps(
LPSPropTagArray lpPropTagArray,
LPSPropProblemArray FAR * lppProblems
);
Parameter
lpPropTagArray
[in] Ein Zeiger auf ein Array von Eigenschaftstags, die die hinzuzufügenden Eigenschaften angeben.
lppProblems
[in, out] Bei der Eingabe ein gültiger Zeiger auf eine SPropProblemArray-Struktur oder NULL. In der Ausgabe ein Zeiger auf einen Zeiger auf eine Struktur, die Informationen zu Eigenschaften enthält, die nicht hinzugefügt werden konnten, oder NULL. Ein Zeiger auf eine Eigenschaftenproblemarraystruktur wird nur zurückgegeben, wenn ein gültiger Zeiger übergeben wird.
Rückgabewert
S_OK
Die Eigenschaften wurden erfolgreich hinzugefügt.
MAPI_E_INVALID_TYPE
Ein anderer Eigenschaftstyp als PT_OBJECT wurde in dem Array übergeben, auf das der lpPropTagArray-Parameter verweist.
MAPI_E_NO_ACCESS
Das -Objekt wurde so festgelegt, dass es keine Lese-/Schreibberechtigung zulässt.
MAPI_W_PARTIAL_COMPLETION
Einige, aber nicht alle Eigenschaften wurden hinzugefügt.
Hinweise
Die IPropData::HrAddObjProps-Methode fügt dem Objekt eine oder mehrere Eigenschaften vom Typ PT_OBJECT hinzu. HrAddObjProps stellt eine Alternative zur IMAPIProp::SetProps-Methode für Objekteigenschaften bereit, da Objekteigenschaften nicht durch Aufrufen von SetProps erstellt werden können. Das Hinzufügen einer Objekteigenschaft führt dazu, dass das Eigenschaftstag in die Liste der Eigenschaftentags aufgenommen wird, die die IMAPIProp::GetPropList-Methode zurückgibt.
Hinweise für Aufrufer
Wenn HrAddObjProps MAPI_W_PARTIAL_COMPLETION zurückgibt und Sie lppProblems auf einen gültigen Zeiger festgelegt haben, überprüfen Sie die zurückgegebene SPropProblemArray-Struktur , um herauszufinden, welche Eigenschaften nicht hinzugefügt wurden. In der Regel ist das einzige Problem, das auftritt, ein mangel an Arbeitsspeicher. Geben Sie die SPropProblemArray-Struktur frei, indem Sie die MAPIFreeBuffer-Funktion aufrufen, wenn Sie damit fertig sind.
Um eine Eigenschaft hinzuzufügen, muss das Zielobjekt über Lese-/Schreibberechtigung verfügen. Wenn HrAddObjProps MAPI_E_NO_ACCESS zurückgibt, können Sie dem Objekt keine Eigenschaften hinzufügen, da es keine Änderung zulässt. Um vor dem Aufrufen von HrAddObjProps Lese-/Schreibberechtigungen für ein Objekt zu erhalten, rufen Sie IPropData::HrSetObjAccess auf, und legen Sie den ulAccess-Parameter auf IPROP_READWRITE fest.