|
ReleaseStgMedium
Frees the specified storage medium.
STGMEDIUM * pmedium
| //Storage medium to be freed
| );
|
|
Parameter
pmedium
Points to the storage medium that is to be freed.
Return Value
None.
Comments
The ReleaseStgMedium function frees the specified storage medium. Use this function during data
transfer operations where storage medium structures are parameters, such as IDataObject::GetData or IDataObject::SetData. This structure specifies the appropriate IUnknown::Release method for releasing the storage medium when it is no longer needed.
The ReleaseStgMedium function calls the appropriate method or function to release the specified
storage medium. Either the original provider of the medium or the receiver of the
medium can call ReleaseStgMedium.
In cases where the original provider of the medium is responsible for freeing
the medium, the provider calls ReleaseStgMedium. The ReleaseStgMedium function first makes a call as described in the following table, depending on
the type of storage medium being freed.
Medium
| ReleaseStgMedium Action
| TYMED_HGLOBAL
| None.
| TYMED_GDI
| None.
| TYMED_ENHMF
| None.
| TYMED_MFPICT
| None.
| TYMED_FILE
| Frees the filename string using standard memory management mechanisms.
| TYMED_ISTREAM
| Calls IStream::Release.
| TYMED_ISTORAGE
| Calls IStorage::Release.
|
After making the call described in the preceding table, ReleaseStgMedium then calls the IUnknown::Release method for the specified storage medium. This method is specified in the
storage medium structure.
In cases where the receiver of the medium is responsible for freeing the
medium, the storage medium structure specifies NULL for the IUnknown::Release method. In this case, the receiver calls ReleaseStgMedium, which makes a call as described in the following table depending on the type
of storage medium being freed.
Medium
| ReleaseStgMedium Action
| TYMED_HGLOBAL
| Calls GlobalFree on the handle.
| TYMED_GDI
| Calls DeleteObject on the handle.
| TYMED_ENHMF
| Deletes the enhanced metafile.
| TYMED_MFPICT
| The hMF that it contains is deleted with DeleteMetaFile; then the handle itself is passed to GlobalFree.
| TYMED_FILE
| Frees the disk file by deleting it. Frees the file name string by using the
standard memory management paradigm.
| TYMED_ISTREAM
| Calls IStream::Release.
| TYMED_ISTORAGE
| Calls IStorage::Release.
|
In either case after the call to ReleaseStgMedium, the specified storage medium is invalid and can no longer be used.
| Last news from Greatis Software |
 |
|
Nostalgia .Net |
|
.Net is powerful, but not all-powerful, so sometimes we need to use Win32 API for our .Net applications. It's simple enough with Platform Invoke if you have Win32 skill, but we do not always have time to dig the ancient documentation, declare the special types that are compatible with Win32, find the values of the Win32's constants and so on. Nostalgia .Net offers several simple-to-use classes, and components that will allow you to forget about the headache of Win32 and just use the power of Win32 in your application the same way as you use the native. Net classes. More » |
| Recommended software for developers |
 |
|
Ultimate Pack |
|
Component pack for Delphi and C++ Builder that contains runtime form designer, runtime object inspector, print suite and much more for the very special price. More » |
 |
|
Form Designer .Net |
|
Unique runtime form design solution that allows to edit any form in .Net WinForms application at runtime with full source codes for only 300 euro! More » |
 |
|
Print Suite .Net |
|
Print Suite .Net is a set of components for easy printing texts, images and grids from your WinForms applications. Full C# source codes are available More » |
 |
|
Gradient Controls .Net |
|
Gradient Controls .Net offers controls with gradient background feature. Labels, panels and so on... Full C# source codes are available More » |
 |
|
Greatis iGrid |
|
iGrid plots drawing grid right over your desktop, so you can use it everywhere, with any drawing application without any special plugins for different graphic editors. More » |
All the contacts and projectsDmitry Vasiliev (just.dmitry)
Related LinksSoftware for Visual Studio .NET developers
Software for Delphi and C++ Builder developers
Software for Visual Basic 6 developers
Delphi Tips&Tricks
MegaDetailed.NET More Online Helps Win32 Programmer's Reference
Win32 Multimedia Programmer's Reference
OLE Programmer's Reference
Microsoft Windows Pen API Programmer's Reference
Microsoft Windows Sockets 2 Reference
Microsoft Windows Telephony API (TAPI) Programmer's Reference
Unix Manual Pages
|
