IOleUndoUnit::OnNextAdd method (ocidl.h)
Memberi tahu unit urungkan terakhir dalam koleksi bahwa unit baru telah ditambahkan.
Sintaks
HRESULT OnNextAdd();
Mengembalikan nilai
Implementasi metode ini selalu mengembalikan S_OK. Jenis pengembalian HRESULT hanya digunakan untuk remotability.
Keterangan
Objek dapat membuat unit urungkan untuk tindakan dan menambahkannya ke manajer urungkan tetapi dapat terus menyisipkan data ke dalamnya melalui antarmuka privat. Ketika unit urungkan menerima panggilan ke metode ini, unit berkomunikasi kembali ke objek pembuatan yang telah diubah konteksnya. Kemudian, objek pembuatan berhenti menyisipkan data ke dalam unit batalkan.
Unit urungkan induk memanggil metode ini pada unit urungkan anak yang terakhir ditambahkan untuk memberi tahu unit turunan bahwa konteks telah berubah dan unit urungkan baru telah ditambahkan.
Misalnya, metode ini digunakan untuk mendukung tindakan fuzzy, seperti mengetik, yang tidak memiliki titik penghentian yang jelas tetapi sebaliknya dihentikan hanya ketika sesuatu yang lain terjadi.
Metode ini mungkin tidak selalu dipanggil jika manajer batalkan atau unit induk terbuka memilih untuk membuang unit dengan memanggil IUnknown::Release sebagai gantinya. Koneksi apa pun yang mengumpankan data ke unit batalkan di belakang layar melalui antarmuka privat tidak boleh IUnknown::AddRef unit urungkan.
Catatan untuk Pelaksana
Perhatikan bahwa unit induk hanya mendelegasikan metode ini ke unit anak yang terakhir ditambahkan. Unit induk harus mengakhiri komunikasi melalui antarmuka privat apa pun saat ditutup. Unit induk tahu sedang ditutup ketika menerima S_FALSE dari memanggil IOleParentUndoUnit::Close.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 |