Bagikan melalui


Metode IOleUndoManager::RedoTo (ocidl.h)

Menginstruksikan manajer urungkan untuk memanggil tindakan batalkan kembali melalui tumpukan fase pengulangan, ke bawah ke dan termasuk unit urungkan yang ditentukan.

Sintaks

HRESULT RedoTo(
  [in] IOleUndoUnit *pUU
);

Parameter

[in] pUU

Penunjuk IOleUndoUnit ke unit tingkat atas untuk diulangi. Jika parameter ini NULL, unit tingkat atas yang terakhir ditambahkan digunakan.

Nilai kembali

Metode ini mengembalikan S_OK pada keberhasilan. Nilai pengembalian lain yang mungkin termasuk yang berikut ini.

Menampilkan kode Deskripsi
E_INVALIDARG
Unit urungkan yang ditentukan tidak ada pada tumpukan fase pengulangan.
E_ABORT
Upaya batalkan dan upaya putar kembali gagal. Manajer urungkan tidak boleh menyebarluaskan E_ABORT yang diperoleh dari unit urungkan yang terkandung. Sebaliknya, ini harus memetakan nilai E_ABORT apa pun yang dikembalikan dari unit urungkan lainnya ke E_FAIL.
E_UNEXPECTED
Manajer urungkan dinonaktifkan.

Keterangan

Metode ini memanggil metode IOleUndoUnit::D o pada setiap unit pembatalan tingkat atas. Kemudian, ia merilis unit urungkan itu.

Perhatikan bahwa unit urungkan yang ditentukan harus merupakan unit tingkat atas, biasanya diambil melalui IOleUndoManager::EnumRedoable.

Jika kesalahan dikembalikan dari unit urungkan, manajer urungkan perlu mencoba mengembalikan status dokumen untuk pulih dari kesalahan dengan melakukan tindakan pada tumpukan urungkan.

Apa pun keberhasilan pemutaran kembali, manajer urungkan harus selalu menghapus kedua tumpukan sebelum mengembalikan kesalahan.

Jika manajer urungkan telah memanggil metode IOleUndoUnit::D o pada lebih dari satu unit tingkat atas, seharusnya hanya memutar kembali unit yang mengembalikan kesalahan. Unit tingkat atas yang berhasil tidak boleh digulung balik.

Manajer pembatalan juga harus melacak apakah unit ditambahkan ke tumpukan yang berlawanan sehingga tidak akan mencoba putar kembali jika tidak ada yang ditambahkan. Lihat antarmuka IOleUndoManager untuk deskripsi terperinci tentang penanganan kesalahan.

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

IOleUndoManager

IOleUndoManager::EnumRedoable

IOleUndoManager::UndoTo

IOleUndoUnit::D o