HrIStorageFromStream

Gilt für: Outlook 2013 | Outlook 2016

Übergibt eine 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 (Interface Identifier, 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 dem Übergeben von IID_IStream.

ulFlags

[in] Bitmaske von Flags, 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 Datenstroms startet. Die folgenden Flags können in beliebiger Kombination festgelegt werden, außer wie angegeben:

STGSTRM_CREATE

Erstellt ein neues Speicherobjekt für das Streamobjekt. Dieses Flag kann nicht festgelegt werden, wenn das STGSTRM_RESET-Flag festgelegt ist.

STGSTRM_CURRENT

Startet die Speicherung an der aktuellen Position des Datenstroms. Dieses Flag kann nicht festgelegt werden, wenn das STGSTRM_RESET-Flag festgelegt ist.

STGSTRM_MODIFY

Ermöglicht dem aufrufenden Dienstanbieter, in den zurückgegebenen Speicher zu schreiben. Dieses Flag kann nicht festgelegt werden, wenn das STGSTRM_RESET-Flag festgelegt ist.

STGSTRM_RESET

Startet die Speicherung an Position 0. Dieses Flag kann nicht festgelegt werden, wenn ein anderes Flag festgelegt 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 Funktion HrIStorageFromStream mithilfe der IStorage-Schnittstelle für Anlagen. Store-Anbieter 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.