Fungsi ReleaseStgMedium (ole2.h)
Membebaskan media penyimpanan yang ditentukan.
Sintaks
void ReleaseStgMedium(
LPSTGMEDIUM unnamedParam1
);
Parameter
unnamedParam1
Nilai kembali
Tidak ada
Keterangan
Fungsi ReleaseStgMedium memanggil metode atau fungsi yang sesuai untuk merilis media penyimpanan yang ditentukan. Gunakan fungsi ini selama operasi transfer data di mana struktur medium penyimpanan adalah parameter, seperti IDataObject::GetData atau IDataObject::SetData. Selain mengidentifikasi jenis media penyimpanan, struktur ini menentukan metode Rilis yang sesuai untuk merilis media penyimpanan saat tidak lagi diperlukan.
Adalah umum untuk meneruskan STGMEDIUM dari satu isi kode ke isi kode lainnya, seperti di IDataObject::GetData, di mana yang dipanggil dapat mengalokasikan media dan mengembalikannya ke pemanggil. ReleaseStgMedium memungkinkan fleksibilitas apakah badan penerima kode memiliki media, atau apakah penyedia asli media masih memilikinya, dalam hal ini kode penerima perlu memberi tahu penyedia bahwa kode tersebut dapat membebaskan media.
Ketika penyedia asli media bertanggung jawab untuk membebaskan media, penyedia memanggil ReleaseStgMedium, menentukan pointer IUnknown yang sesuai sebagai anggota struktur punkForRelease . Bergantung pada jenis media penyimpanan yang dibebaskan, salah satu tindakan berikut diambil, diikuti dengan panggilan ke metode IUnknown::Release pada pointer IUnknown yang ditentukan.
| Medium | Tindakan ReleaseStgMedium |
|---|---|
| TYMED_HGLOBAL | Tidak ada. |
| TYMED_GDI | Tidak ada. |
| TYMED_ENHMF | Tidak ada. |
| TYMED_MFPICT | Tidak ada. |
| TYMED_FILE | Membebaskan string nama file menggunakan mekanisme manajemen memori standar. |
| TYMED_ISTREAM | Memanggil IStream::Release. |
| TYMED_ISTORAGE | Memanggil IStorage::Release. |
Penyedia menunjukkan bahwa penerima media bertanggung jawab untuk membebaskan media dengan menentukan NULL untuk anggota struktur punkForRelease . Kemudian penerima memanggil ReleaseStgMedium, yang melakukan panggilan seperti yang dijelaskan dalam tabel berikut tergantung pada jenis media penyimpanan yang dibebaskan.
| Medium | Tindakan ReleaseStgMedium |
|---|---|
| TYMED_HGLOBAL | Memanggil fungsi GlobalFree pada handel. |
| TYMED_GDI | Memanggil fungsi DeleteObject pada handel. |
| TYMED_ENHMF | Menghapus metafile yang ditingkatkan. |
| TYMED_MFPICT | HMF yang dikandungnya dihapus dengan fungsi DeleteMetaFile ; kemudian handel itu sendiri diteruskan ke GlobalFree. |
| TYMED_FILE | Membebaskan file disk dengan menghapusnya. Membebaskan string nama file dengan menggunakan mekanisme manajemen memori standar. |
| TYMED_ISTREAM | Memanggil IStream::Release. |
| TYMED_ISTORAGE | Memanggil IStorage::Release. |
Dalam kedua kasus, setelah panggilan ke ReleaseStgMedium, media penyimpanan yang ditentukan tidak valid dan tidak dapat digunakan lagi.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung | Windows 2000 Professional [hanya aplikasi desktop] |
| Server minimum yang didukung | Windows 2000 Server [hanya aplikasi desktop] |
| Target Platform | Windows |
| Header | ole2.h |
| Pustaka | Ole32.lib |
| DLL | Ole32.dll |
| Set API | ext-ms-win-com-ole32-l1-1-3 (diperkenalkan dalam Windows 10, versi 10.0.10240) |