Freigeben über


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

lpPropTagArray

[in] Zeiger auf eine SPropTagArray-Struktur, die ein Array von Eigenschaftentags 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 diese wurden mit dem Eigenschaftentyp PT_ERROR zurückgegeben.

Hinweise

Auf Eigenschaftsattribute kann nur auf Eigenschaftenobjekte 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 Eigenschaftenattribute für solche Objekte können mit SetAttribIMsgOnIStg festgelegt oder geändert und mit GetAttribIMsgOnIStg abgerufen werden.

Hinweis

GetAttribIMsgOnIStg- und SetAttribIMsgOnIStg werden nicht für alle IMessage-Objekte ausgeführt. Sie sind nur für IMessage-on- IStorage-Objekte gültig, die von OpenIMsgOnIStgzurückgegeben werden.

Die Anzahl und Positionen der Attribute im lppPropAttrArray-Parameter entsprechen der Anzahl und den Positionen der Eigenschaftstags im lpPropTagArray-Parameter.