GetHGlobalFromStream
Retrieves the
global memory handle to a stream that was created through a call to the CreateStreamOnHGlobal function.
WINOLEAPI GetHGlobalFromStream(
|
IStream * pstm, |
//Points
to the stream object |
|
HGLOBAL * phglobal |
//Points
to the current memory handle for the specified stream |
|
); |
|
Parameters
pstm
[in] IStream pointer to the stream
object previously created by a call to the CreateStreamOnHGlobal function.
phglobal
[out] Points
to the current memory handle used by the specified stream object.
Return Values
S_OK
Indicates the
handle was successfully returned.
E_INVALIDARG
Indicates
invalid value specified for the pstm parameter. It can also indicate
that the stream object passed in is not one created by a call to the CreateStreamOnHGlobal function.
Comments
The handle
this function returns may be different from the original handle due to
intervening GlobalRealloc calls.
This function
can be called only from within the same process from which the byte array was
created.
See Also
GlobalRealloc in Win32