Returns an OLE-provided implementation of the IStream
interface with the stream object stored in global memory.
| HGLOBAL hGlobal,
||//Memory handle for the stream object
| BOOL fDeleteOnRelease,
||//Indicates whether to free memory when the object is released
| LPSTREAM * ppstm
||//Points to location for pointer to the new stream object
Contains the memory handle allocated by the GlobalAlloc
function. The handle must be allocated as moveable and nondiscardable. If the
handle is to be shared between processes, it must also be allocated as shared.
New handles should be allocated with a size of zero. If hGlobal
is NULL, the CreateStreamOnHGlobal
function internally allocates a new shared memory block of size zero.
Indicates whether the underlying handle for this stream object should be
automatically freed when the stream object is released.
Points to the location where this method places a pointer to the new stream
object, that is, the new IStream
instance. It cannot be NULL.
Indicates the stream object was created successfully.
Indicates the stream could not be created due to lack of memory.
Indicates invalid value for one of the parameters.
This function creates a stream object in memory using the OLE-provided
implementation of the IStream
interface. The returned stream object supports both reading and writing, is
not transacted, and does not support locking.
The initial contents of the stream are the current contents of the memory
block provided in the hGlobal
parameter. If the hGlobal
paramter is NULL, this function internally allocates memory.
The current contents of the memory block are undisturbed by the creation of
the new stream object. Thus, you can use this function to open an existing stream
The initial size of the stream is the size of the memory handle returned by
the Win32 GlobalSize
function. Because of rounding, this is not necessarily the same size that was
originally allocated for the handle. If the logical size of the stream is
important, you should follow the call to this function with a call to the IStream::SetSize
GlobalSize in Win32
- Software for developers
Software for Android Developers
- More information resources
Unix Manual Pages