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.

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.