SetAttribIMsgOnIStg
Gilt für: Outlook 2013 | Outlook 2016
Legt Attribute von Eigenschaften für ein IMessage-Objekt fest, das von der OpenIMsgOnIStg-Funktion bereitgestellt wird, oder ändert diese.
| Eigenschaft | Wert |
|---|---|
| Headerdatei |
Imessage.h |
| Implementiert von: |
MAPI |
| Aufgerufen von: |
Clientanwendungen und Nachrichtenspeicheranbieter |
HRESULT SetAttribIMsgOnIStg(
LPVOID lpObject,
LPSPropTagArray lpPropTags,
LPSPropAttrArray lpPropAttrs,
LPSPropProblemArray FAR * lppPropProblems
);
Parameter
lpObject
[in] Zeiger auf das Objekt, für das Eigenschaftsattribute festgelegt werden.
lpPropTags
[in] Zeiger auf eine SPropTagArray-Struktur , die ein Array von Eigenschaftstags enthält, die die Eigenschaften angeben, für die Eigenschaftsattribute festgelegt werden.
lpPropAttrs
[in] Zeiger auf eine SPropAttrArray-Struktur , die die festzulegenden Eigenschaftsattribute auflistet.
lppPropProblems
[out] Zeiger auf die zurückgegebene SPropProblemArray-Struktur , die eine Reihe von Eigenschaftenproblemen enthält. Diese Struktur identifiziert Probleme, die auftreten, wenn SetAttribIMsgOnIStg einige Eigenschaften festlegen konnte, aber nicht alle. Wenn im lppPropProblems-Parameter ein Zeiger auf NULL übergeben wird, wird kein Eigenschaftenproblemarray zurückgegeben, auch wenn einige Eigenschaften nicht festgelegt wurden.
Rückgabewert
S_OK
Der Aufruf erfolgreich ausgef�hrt und der erwartete Wert oder Werte zur�ckgegeben hat.
MAPI_W_ERRORS_RETURNED
Der Aufruf war insgesamt erfolgreich, aber auf eine oder mehrere Eigenschaften konnte nicht zugegriffen werden und wurde mit dem Eigenschaftentyp PT_ERROR zurückgegeben.
Hinweise
Auf Eigenschaftsattribute kann nur für Eigenschaftsobjekte zugegriffen werden, d. h. auf Objekte, die die IMAPIProp:IUnknown-Schnittstelle implementieren. Um MAPI-Eigenschaften für ein strukturiertes OLE-Speicherobjekt verfügbar zu machen, erstellt OpenIMsgOnIStg ein IMessage: IMAPIProp-Objekt auf dem OLE IStorage-Objekt . Die Eigenschaftsattribute für solche Objekte können mit SetAttribIMsgOnIStg festgelegt oder geändert und mit GetAttribIMsgOnIStg abgerufen werden.
HinweisGetAttribIMsgOnIStg und SetAttribIMsgOnIStg funktionieren nicht für alle IMessage-Objekte . Sie sind nur für IMessage-on-IStorage-Objekte gültig, die von OpenIMsgOnIStg zurückgegeben werden.
Im lpPropAttrs-Parameter müssen die Anzahl und Position der Attribute mit der Anzahl und Position der Eigenschaftstags übereinstimmen, die im lpPropTags-Parameter übergeben werden.
Die Funktion SetAttribIMsgOnIStg wird verwendet, um Nachrichteneigenschaften schreibgeschützt zu machen, wenn dies für das IMessage-Schema erforderlich ist. Der Beispielnachrichtenspeicheranbieter verwendet ihn zu diesem Zweck. Weitere Informationen finden Sie unter Nachrichten.