Bagikan melalui

IPropertyBag::Metode tulis (oaidl.h)

  • Artikel

Simpan properti bernama dalam VARIAN yang diinisialisasi pemanggil.

Sintaks

HRESULT Write(
  LPCOLESTR pszPropName,
  VARIANT   *pVar
);

Parameter

pszPropName

Alamat string yang berisi nama properti untuk ditulis. Ini tidak boleh NULL.

pVar

Alamat VARIAN yang diinisialisasi pemanggil yang menyimpan nilai properti. Pemanggil memiliki VARIAN ini, dan bertanggung jawab atas semua alokasinya. Artinya, tas properti tidak mencoba membebaskan data di VARIAN.

Keterangan

Metode Tulis memberi tahu tas properti untuk menyimpan properti bernama dengan pszPropName dengan menggunakan jenis dan nilai dalam VARIAN yang diinisialisasi pemanggil di pVar. Dalam beberapa kasus, penelepon mungkin memberi tahu tas properti untuk menyimpan objek lain, misalnya, ketika pVar->vt VT_UNKNOWN. Dalam kasus seperti itu, tas properti meminta penunjuk objek ini untuk antarmuka persistensi, seperti IPersistStream atau IPersistPropertyBag, dan meminta objek tersebut menyimpan datanya juga. Biasanya ini menghasilkan tas properti yang memiliki beberapa array byte untuk objek ini, yang dapat disimpan sebagai teks yang dikodekan, seperti string heksadesimal, MIME, dan sebagainya. Ketika tas properti kemudian digunakan untuk menginisialisasi ulang kontrol, klien yang memiliki tas properti harus membuat ulang objek ketika pemanggil memintanya, menginisialisasi objek tersebut dengan bit yang disimpan sebelumnya.

Ini memungkinkan operasi persistensi yang efisien untuk properti Objek Besar Biner (BLOB), seperti gambar, di mana pemilik tas properti memberi tahu objek gambar (yang dikelola sebagai properti dalam kontrol yang disimpan) untuk disimpan ke lokasi tertentu. Ini menghindari potensi operasi salinan tambahan yang mungkin terlibat dengan mekanisme persistensi berbasis properti lainnya.

E_NOTIMPL bukan kode pengembalian yang valid, karena objek apa pun yang mengimplementasikan antarmuka ini harus mendukung seluruh fungsi antarmuka.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows 10 Build 20348
Server minimum yang didukung Windows 10 Build 20348
Header oaidl.h