Metode IOleCache::SetData (oleidl.h)
Menginisialisasi cache dengan data dalam format tertentu dan pada media tertentu.
Sintaks
HRESULT SetData(
[in] FORMATETC *pformatetc,
[in] STGMEDIUM *pmedium,
[in] BOOL fRelease
);
Parameter
[in] pformatetc
Penunjuk ke struktur FORMATETC yang menentukan format data presentasi yang ditempatkan dalam cache.
[in] pmedium
Penunjuk ke struktur STGMEDIUM yang menentukan media penyimpanan yang berisi data presentasi.
[in] fRelease
Menunjukkan kepemilikan media penyimpanan setelah penyelesaian metode. Jika fReleaseTRUE, cache mengambil kepemilikan, membebaskan media ketika selesai menggunakannya. Ketika fReleasefalse, penelepon mempertahankan kepemilikan dan bertanggung jawab untuk membebaskan media. Cache hanya dapat menggunakan media penyimpanan selama panggilan.
Nilai kembali
Metode ini mengembalikan S_OK pada keberhasilan. Nilai pengembalian lain yang mungkin termasuk yang berikut ini.
Menampilkan kode | Deskripsi |
---|---|
|
Nilai tidak valid untuk pformatetc-lindex>. Saat ini, hanya -1 yang didukung. |
|
Struktur FORMATETC tidak valid. |
|
Nilai tidak valid untuk pformatetc-tymed>. |
|
Nilai tidak valid untuk pformatetc-dwAspect>. |
|
Ada objek yang tidak diinisialisasi. |
|
Objek statis dan pformatetc-ptd> adalahnon-NULL. |
|
Media penyimpanan penuh. |
Keterangan
IOleCache::SetData biasanya dipanggil saat objek dibuat dari clipboard atau melalui operasi seret dan letakkan, dan data Sumber Semat digunakan untuk membuat objek.
IOleCache::SetData dan IOleCache::InitCache sangat mirip. Ada dua perbedaan utama. Perbedaan pertama adalah bahwa sementara IOleCache::InitCache menginisialisasi cache dengan format presentasi yang disediakan oleh objek data, IOleCache::SetData menginisialisasinya dengan satu format. Kedua, metode IOleCache::SetData mengabaikan bendera ADVF_NODATA sementara IOleCache::InitCache mematuhi bendera ini.
Kontainer dapat menggunakan metode ini untuk mempertahankan satu aspek objek, seperti aspek ikon objek.
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 | oleidl.h |