Metode IOleCache::SetData (oleidl.h)

Artikel
03/01/2024

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
DV_E_LINDEX	Nilai tidak valid untuk pformatetc-lindex>. Saat ini, hanya -1 yang didukung.
DV_E_FORMATETC	Struktur FORMATETC tidak valid.
DV_E_TYMED	Nilai tidak valid untuk pformatetc-tymed>.
DV_E_DVASPECT	Nilai tidak valid untuk pformatetc-dwAspect>.
OLE_E_BLANK	Ada objek yang tidak diinisialisasi.
DV_E_TARGETDEVICE	Objek statis dan pformatetc-ptd> adalahnon-NULL.
STG_E_MEDIUMFULL	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

Lihat juga

IOleCache

IOleCache::Cache

IOleCache::SetData

Bagikan melalui