Skip to content

Latest commit

 

History

History
84 lines (53 loc) · 2.63 KB

hristoragefromstream.md

File metadata and controls

84 lines (53 loc) · 2.63 KB
Raw
title description manager ms.date ms.audience ms.topic ms.service ms.localizationpriority api_name api_type ms.assetid
HrIStorageFromStream
This article describes HrIStorageFromStream, it provides syntax, parameters, return value, and additional remarks.
lindalu
03/09/2015
Developer
reference
office-online-server
medium
HrIStorageFromStream
HeaderDef
1cdc95b8-a156-4600-9e20-caaa02680e87

HrIStorageFromStream

Applies to: Outlook 2013 | Outlook 2016

Layers an IStorage interface onto an IStream object.

Property Value
Header file:
Mapiutil.h
Implemented by:
MAPI
Called by:
Client applications and service providers 
HRESULT HrIStorageFromStream(
  LPUNKNOWN lpUnkIn,
  PIID lpInterface,
  ULONG ulFlags,
  LPSTORAGE FAR * lppStorageOut
);

Parameters

lpUnkIn

[in] Pointer to the IUnknown object implementing IStream.

lpInterface

[in] Pointer to the interface identifier (IID) for the stream object. Any of the following values can be passed in the lpInterface parameter: NULL, IID_IStream, or IID_ILockBytes. Passing NULL in lpInterface is the same as passing IID_IStream.

ulFlags

[in] Bitmask of flags that controls how the storage object is to be created relative to the stream. The default setting is STGSTRM_RESET, which gives the storage object read-only access and starts it at position zero of the stream. The following flags can be set in any combination, except as noted:

STGSTRM_CREATE

Creates a new storage object for the stream object. This flag cannot be set if the STGSTRM_RESET flag is set.

STGSTRM_CURRENT

Starts storage at the current position of the stream. This flag cannot be set if the STGSTRM_RESET flag is set.

STGSTRM_MODIFY

Allows the calling service provider to write to the returned storage. This flag cannot be set if the STGSTRM_RESET flag is set.

STGSTRM_RESET

Starts storage at position zero. This flag cannot be set if any other flag is set.

lppStorageOut

[out] Pointer to a pointer to the returned IStorage object.

Return value

S_OK

The call succeeded and has returned the expected value or values.

Remarks

Message store providers support the HrIStorageFromStream function using the IStorage interface for attachments. Store providers must implement the IStream interface. HrIStorageFromStream provides the IStorage interface for the IStream object. It is possible to pass either an ILockBytes or an IStream interface in lpUnkIn.