Bagikan melalui

Metode IPropertyNotifySink::OnRequestEdit (ocidl.h)

  • Artikel

Memberi tahu sink bahwa properti requestedit akan berubah.

Sintaks

HRESULT OnRequestEdit(
  [in] DISPID dispID
);

Parameter

[in] dispID

Pengidentifikasi pengiriman properti yang akan berubah atau DISPID_UNKNOWN jika beberapa properti akan berubah.

Nilai kembali

Metode ini dapat mengembalikan nilai berikut.

Menampilkan kode Deskripsi
S_OK
 Properti atau properti yang ditentukan diizinkan untuk diubah.
S_FALSE
 Properti atau properti yang ditentukan tidak diizinkan untuk diubah. Pemanggil harus mematuhi nilai pengembalian ini dengan membuang nilai properti baru. Ini adalah bagian dari kontrak atribut [requestedit] dan metode ini.

Keterangan

Sink dapat memilih untuk mengizinkan atau melarang perubahan terjadi. Misalnya, sink dapat memberlakukan status baca-saja pada properti . DISPID_UNKNOWN adalah parameter yang valid untuk metode ini untuk menunjukkan bahwa beberapa properti akan berubah. Dalam hal ini, sink dapat memberlakukan status baca-saja global untuk semua properti [requestedit] dalam objek, termasuk properti tertentu yang dikenali oleh sink.

Jika sink memungkinkan perubahan, objek juga harus membuat pemberitahuan IPropertyNotifySink::OnChanged untuk properti apa pun yang ditandai [dapat diikat] selain [requestedit].

Metode ini tidak dapat digunakan untuk mengimplementasikan segala jenis validasi data. Pada saat panggilan, nilai baru properti yang diinginkan tidak tersedia dan dengan demikian tidak dapat divalidasi. Satu-satunya tujuan metode ini adalah untuk memungkinkan sink memberlakukan status baca-saja pada properti .

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 ocidl.h

Lihat juga

IPropertyNotifySink