Metode IPropertyNotifySink::OnRequestEdit (ocidl.h)
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 |
|---|---|
|
Properti atau properti yang ditentukan diizinkan untuk diubah. |
|
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 |