HrIStorageFromStream

Gilt für: Outlook 2013 | Outlook 2016

Schichtet einer IStorage-Schnittstelle auf ein IStream-Objekt.

Eigenschaft	Wert
Headerdatei	Mapiutil.h
Implementiert von:	MAPI
Aufgerufen von:	Clientanwendungen und Dienstanbieter

HRESULT HrIStorageFromStream(
  LPUNKNOWN lpUnkIn,
  PIID lpInterface,
  ULONG ulFlags,
  LPSTORAGE FAR * lppStorageOut
);

Parameter

lpUnkIn

[in] Zeiger auf das IUnknown-Objekt, das IStream implementiert.

lpInterface

[in] Zeiger auf den Schnittstellenbezeichner (IID) für das Streamobjekt. Jeder der folgenden Werte kann im lpInterface-Parameter übergeben werden: NULL, IID_IStream oder IID_ILockBytes. Das Übergeben von NULL in lpInterface entspricht der Übergabe IID_IStream.

ulFlags

[in] Bitmaske von Kennzeichnungen, die steuert, wie das Speicherobjekt relativ zum Stream erstellt werden soll. Die Standardeinstellung ist STGSTRM_RESET, die dem Speicherobjekt schreibgeschützten Zugriff gewährt und es an Position 0 des Streams startet. Die folgenden Kennzeichnungen können in beliebiger Kombination festgelegt werden, außer wie angegeben:

STGSTRM_CREATE

Erstellt ein neues Speicherobjekt für das Streamobjekt. Diese Kennzeichnung kann nicht festgelegt werden, wenn die STGSTRM_RESET-Kennzeichnung gesetzt ist.

STGSTRM_CURRENT

Startet die Speicherung an der aktuellen Position des Streams. Diese Kennzeichnung kann nicht festgelegt werden, wenn die STGSTRM_RESET-Kennzeichnung gesetzt ist.

STGSTRM_MODIFY

Ermöglicht dem aufrufenden Dienstanbieter, in den zurückgegebenen Speicher zu schreiben. Diese Kennzeichnung kann nicht festgelegt werden, wenn die STGSTRM_RESET-Kennzeichnung gesetzt ist.

STGSTRM_RESET

Beginnt die Speicherung an Position Null. Diese Kennzeichnung kann nicht gesetzt werden, wenn eine andere Kennzeichnung aktiv ist.

lppStorageOut

[out] Zeiger auf einen Zeiger auf das zurückgegebene IStorage-Objekt.

Rückgabewert

S_OK

Der Aufruf erfolgreich ausgeführt und der erwartete Wert oder Werte zurückgegeben hat.

Hinweise

Nachrichtenspeicheranbieter unterstützen die HrIStorageFromStream-Funktion mithilfe der IStorage-Schnittstelle für Anlagen. Speicheranbieter müssen die IStream-Schnittstelle implementieren. HrIStorageFromStream stellt die IStorage-Schnittstelle für das IStream-Objekt bereit. Es ist möglich, entweder eine ILockBytes oder eine IStream-Schnittstelle in lpUnkIn zu übergeben.