GetAttribIMsgOnIStg

Gilt für: Outlook 2013 | Outlook 2016

Ruft Attribute von Eigenschaften für ein IMessage-Objekt ab, das von der OpenIMsgOnIStg-Funktion bereitgestellt wird.

Eigenschaft	Wert
Headerdatei	Imessage.h
Implementiert von:	MAPI
Aufgerufen von:	Clientanwendungen und Nachrichtenspeicheranbieter

HRESULT GetAttribIMsgOnIStg(
  LPVOID lpObject,
  LPSPropTagArray lpPropTagArray,
  LPSPropAttrArray FAR * lppPropAttrArray
);

Parameter

lpObject

[in] Zeiger auf ein IMessage-Objekt , das von der OpenIMsgOnIStg-Funktion abgerufen wird.

lpPropTagArray

[in] Zeiger auf eine SPropTagArray-Struktur , die ein Array von Eigenschaftstags enthält, die die Eigenschaften angeben, für die Attribute abgerufen werden sollen.

lppPropAttrArray

[out] Zeiger auf einen Zeiger auf die zurückgegebene SPropAttrArray-Struktur , die die abgerufenen Eigenschaftsattribute enthält.

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.

Hinweis

GetAttribIMsgOnIStg 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.

Die Anzahl und Position der Attribute im lppPropAttrArray-Parameter entsprechen der Anzahl und position der Eigenschaftstags im lpPropTagArray-Parameter .