IOleUndoManager::D iscardDari metode (ocidl.h)
Menginstruksikan manajer batalkan untuk membuang unit urungkan yang ditentukan dan semua unit urungkan di bawahnya pada tumpukan urungkan atau ulangi.
Sintaks
HRESULT DiscardFrom(
[in] IOleUndoUnit *pUU
);
Parameter
[in] pUU
Penunjuk IOleUndoUnit ke unit batalkan untuk dibuang. Parameter ini dapat berupa NULL untuk membuang seluruh tumpukan batalkan atau ulangi. Jika parameter bukan NULL , tumpukan tidak akan dibuang.
Mengembalikan nilai
Metode ini mengembalikan S_OK pada keberhasilan. Kemungkinan nilai pengembalian lainnya termasuk yang berikut ini.
| Menampilkan kode | Deskripsi |
|---|---|
|
Unit urungkan yang ditentukan tidak ditemukan di tumpukan. |
|
Manajer urungkan dinonaktifkan. |
Keterangan
Manajer batalkan terlebih dahulu mencari tumpukan urungkan untuk unit yang diberikan, dan jika tidak ditemukan di sana, cari tumpukan ulang. Setelah ditemukan, unit yang diberikan dan semua di bawahnya pada tumpukan yang sama dibuang. Unit batalkan mungkin merupakan anak dari unit induk yang dimuat oleh manajer urungkan, seperti yang ditentukan dengan memanggil IOleParentUndoUnit::FindUnit. Jika itu adalah unit anak, maka unit akar yang berisi unit yang diberikan dan semua unit di bawahnya pada tumpukan yang sesuai akan dibuang.
Jika ada unit induk terbuka dan metode DiscardFrom dipanggil dan parameter pUU adalah NULL, manajer urungkan harus segera melepaskan dan membuang unit induk terbuka tanpa memanggil IOleUndoManager::Tutup terlebih dahulu. Ketika objek yang membuka unit induk mencoba menutupnya, IOleUndoManager::Close akan mengembalikan S_FALSE. Jika unit induk terbuka, buang dan buang tumpukan. Jika unit induk tidak terbuka, buang saja tumpukannya. Jika parameter pUU bukan NULL, unit induk yang terbuka harus dibiarkan terbuka.
Persyaratan
| 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 |