GetHGlobalFromStream function (combaseapi.h)

The GetHGlobalFromStream function retrieves the global memory handle to a stream that was created through a call to the CreateStreamOnHGlobal function.

Syntax

HRESULT GetHGlobalFromStream(
  [in]  LPSTREAM pstm,
  [out] HGLOBAL  *phglobal
);

Parameters

[in] pstm

IStream pointer to the stream object previously created by a call to the CreateStreamOnHGlobal function.

[out] phglobal

Pointer to the current memory handle used by the specified stream object.

Return value

This function returns HRESULT.

Remarks

The handle GetHGlobalFromStream 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.

Requirements

See also

CreateStreamOnHGlobal

GlobalReAlloc