Kelas CDataRecoveryHandler

Menyimpan CDataRecoveryHandler dokumen secara otomatis dan memulihkannya jika aplikasi tiba-tiba keluar.

Sintaks

class CDataRecoveryHandler : public CObject

Anggota

Konstruktor

Nama	Deskripsi
CDataRecoveryHandler::CDataRecoveryHandler	Membuat CDataRecoveryHandler objek.

Metode

Nama	Deskripsi
CDataRecoveryHandler::AutosaveAllDocumentInfo	Simpan otomatis setiap file yang terdaftar di CDataRecoveryHandler kelas .
CDataRecoveryHandler::AutosaveDocumentInfo	Simpan otomatis dokumen yang ditentukan.
CDataRecoveryHandler::CreateDocumentInfo	Menambahkan dokumen ke daftar dokumen yang terbuka.
CDataRecoveryHandler::D eleteAllAutosavedFiles	Menghapus semua berkas yang disimpan otomatis saat ini.
CDataRecoveryHandler::D eleteAutosavedFile	Menghapus file yang disimpan otomatis yang ditentukan.
CDataRecoveryHandler::GenerateAutosaveFileName	Menghasilkan nama untuk file simpan otomatis yang terkait dengan nama file dokumen yang disediakan.
CDataRecoveryHandler::GetAutosaveInterval	Mengembalikan interval antara percobaan penyimpanan otomatis.
CDataRecoveryHandler::GetAutosavePath	Mengembalikan jalur file yang disimpan otomatis.
CDataRecoveryHandler::GetDocumentListName	Mengambil nama dokumen dari CDocument objek.
CDataRecoveryHandler::GetNormalDocumentTitle	Mengambil judul normal untuk dokumen yang ditentukan.
CDataRecoveryHandler::GetRecoveredDocumentTitle	Membuat dan mengembalikan judul untuk dokumen yang dipulihkan.
CDataRecoveryHandler::GetRestartIdentifier	Mengambil pengidentifikasi hidupkan ulang unik untuk aplikasi.
CDataRecoveryHandler::GetSaveDocumentInfoOnIdle	Menunjukkan apakah CDataRecoveryHandler melakukan penyimpanan otomatis pada perulangan diam saat ini.
CDataRecoveryHandler::GetShutdownByRestartManager	Menunjukkan apakah manajer hidupkan ulang menyebabkan aplikasi keluar.
CDataRecoveryHandler::Initialize	Menginisialisasi CDataRecoveryHandler.
CDataRecoveryHandler::QueryRestoreAutosavedDocuments	Menampilkan kotak dialog kepada pengguna untuk setiap dokumen yang CDataRecoveryHandler disimpan secara otomatis. Kotak dialog menentukan apakah pengguna ingin memulihkan dokumen yang disimpan otomatis.
CDataRecoveryHandler::ReadOpenDocumentList	Memuat daftar dokumen yang terbuka dari registri.
CDataRecoveryHandler::RemoveDocumentInfo	Menghapus dokumen yang disediakan dari daftar dokumen yang terbuka.
CDataRecoveryHandler::ReopenPreviousDocuments	Membuka dokumen yang dibuka sebelumnya.
CDataRecoveryHandler::RestoreAutosavedDocuments	Memulihkan dokumen yang disimpan otomatis berdasarkan input pengguna.
CDataRecoveryHandler::SaveOpenDocumentList	Menyimpan daftar dokumen terbuka saat ini ke registri Windows.
CDataRecoveryHandler::SetAutosaveInterval	Mengatur waktu antara siklus penyimpanan otomatis dalam milidetik.
CDataRecoveryHandler::SetAutosavePath	Mengatur direktori tempat file yang disimpan otomatis disimpan.
CDataRecoveryHandler::SetRestartIdentifier	Mengatur pengidentifikasi hidupkan ulang unik untuk instans ini dari CDataRecoveryHandler.
CDataRecoveryHandler::SetSaveDocumentInfoOnIdle	Mengatur apakah CDataRecoveryHandler menyimpan informasi dokumen terbuka ke registri Windows selama siklus menganggur saat ini.
CDataRecoveryHandler::SetShutdownByRestartManager	Mengatur apakah keluarnya aplikasi sebelumnya disebabkan oleh manajer hidupkan ulang.
CDataRecoveryHandler::UpdateDocumentInfo	Memperbarui informasi untuk dokumen karena pengguna menyimpannya.

Anggota Data

Nama	Deskripsi
m_bRestoringPreviousOpenDocs	Menunjukkan apakah penangan pemulihan data membuka kembali dokumen yang sebelumnya terbuka.
m_bSaveDocumentInfoOnIdle	Menunjukkan apakah penangan pemulihan data simpan dokumen secara otomatis pada perulangan diam berikutnya.
m_bShutdownByRestartManager	Menunjukkan apakah manajer hidupkan ulang menyebabkan aplikasi keluar.
m_dwRestartManagerSupportFlags	Bendera yang menunjukkan dukungan apa yang disediakan manajer hidupkan ulang untuk aplikasi.
m_lstAutosavesToDelete	Daftar file yang disimpan otomatis yang tidak dihapus ketika dokumen asli ditutup. Ketika aplikasi keluar, manajer mulai ulang mencoba menghapus file.
m_mapDocNameToAutosaveName	Peta nama dokumen ke nama file yang disimpan otomatis.
m_mapDocNameToDocumentPtr	Peta nama dokumen ke penunjuk CDocument .
m_mapDocNameToRestoreBool	Peta nama dokumen ke parameter Boolean yang menunjukkan apakah akan memulihkan dokumen yang disimpan otomatis.
m_mapDocumentPtrToDocName	Peta penunjuk CDocument ke nama dokumen.
m_mapDocumentPtrToDocTitle	Peta penunjuk CDocument ke judul dokumen. Judul ini digunakan untuk menyimpan file.
m_nAutosaveInterval	Waktu dalam milidetik antara penyimpanan otomatis.
m_nTimerID	Pengidentifikasi untuk timer penyimpanan otomatis.
m_strAutosavePath	Lokasi penyimpanan dokumen yang disimpan secara otomatis.
m_strRestartIdentifier	Representasi string GUID untuk manajer hidupkan ulang.

Keterangan

Manajer mulai ulang menggunakan CDataRecoveryHandler kelas untuk melacak semua dokumen yang terbuka dan menyimpannya secara otomatis seperlunya. Untuk mengaktifkan penyimpanan otomatis, gunakan metode CDataRecoveryHandler::SetSaveDocumentInfoOnIdle . Metode ini mengarahkan CDataRecoveryHandler untuk melakukan penyimpanan otomatis pada perulangan diam berikutnya. Manajer mulai ulang memanggil SetSaveDocumentInfoOnIdle kapan CDataRecoveryHandler harus melakukan penyimpanan otomatis.

Semua metode CDataRecoveryHandler kelas bersifat virtual. Ambil alih metode di kelas ini untuk membuat penanganan pemulihan data kustom Anda sendiri. Kecuali Anda membuat handler pemulihan data Anda sendiri atau menghidupkan ulang manajer, jangan membuat instans CDataRecoveryHandler. Kelas CWinApp membuat CDataRecoveryHandler objek karena diperlukan.

Sebelum dapat menggunakan CDataRecoveryHandler objek, Anda harus memanggil CDataRecoveryHandler::Initialize.

CDataRecoveryHandler Karena kelas terhubung erat ke manajer hidupkan ulang, CDataRecoveryHandler tergantung pada parameter m_dwRestartManagerSupportFlagsglobal . Parameter ini menentukan izin apa yang dimiliki manajer hidupkan ulang dan bagaimana ia berinteraksi dengan aplikasi Anda. Untuk menggabungkan manajer hidupkan ulang ke dalam aplikasi yang ada, Anda harus menetapkan m_dwRestartManagerSupportFlags nilai yang sesuai dalam konstruktor aplikasi utama Anda. Untuk informasi selengkapnya tentang cara menggunakan manajer hidupkan ulang, lihat Cara: Menambahkan Dukungan Restart Manager.

Persyaratan

Header: afxdatarecovery.h

CDataRecoveryHandler::AutosaveAllDocumentInfo

Simpan otomatis setiap file yang terdaftar di CDataRecoveryHandler kelas .

virtual BOOL AutosaveAllDocumentInfo();

Tampilkan Nilai

TRUE jika CDataRecoveryHandler menyimpan semua dokumen; FALSE jika ada dokumen yang tidak disimpan.

Keterangan

Metode ini mengembalikan TRUE jika tidak ada dokumen yang harus disimpan. Ini juga mengembalikan TRUE tanpa menyimpan dokumen apa pun jika mengambil CWinApp atau CDocManager untuk aplikasi menghasilkan kesalahan.

Untuk menggunakan metode ini, AFX_RESTART_MANAGER_AUTOSAVE_AT_RESTART atau AFX_RESTART_MANAGER_AUTOSAVE_AT_INTERVAL harus diatur dalam m_dwRestartManagerSupportFlags. Untuk informasi selengkapnya, lihat Cara: Menambahkan Dukungan Restart Manager.

CDataRecoveryHandler::AutosaveDocumentInfo

Simpan otomatis dokumen yang ditentukan.

virtual BOOL AutosaveDocumentInfo(
    CDocument* pDocument,
    BOOL bResetModifiedFlag = TRUE);

Parameter

pDocument
[di] Penunjuk ke CDocument untuk menyimpan.

bResetModifiedFlag
[di] TRUE menunjukkan bahwa CDataRecoveryHandler pertimbangan pDocument untuk dimodifikasi; FALSE menunjukkan bahwa kerangka kerja menganggap pDocument tidak dimodifikasi. Lihat bagian Keterangan untuk informasi selengkapnya tentang efek bendera ini.

Tampilkan Nilai

TRUE jika bendera yang sesuai diatur dan pDocument adalah objek yang valid CDocument .

Keterangan

Setiap CDocument objek memiliki bendera yang menunjukkan apakah objek telah berubah sejak penyimpanan terakhir. Gunakan CDocument::IsModified untuk menentukan status bendera ini. CDocument Jika belum berubah sejak penyimpanan terakhir, AutosaveDocumentInfo menghapus file yang disimpan otomatis untuk dokumen tersebut. Jika dokumen telah berubah sejak penyimpanan terakhir, menutupnya akan meminta pengguna untuk menyimpan dokumen sebelum menutup.

Catatan

Menggunakan bResetModifiedFlag untuk mengubah status dokumen menjadi tidak dimodifikasi dapat menyebabkan pengguna kehilangan data yang tidak disimpan. Jika kerangka kerja menganggap dokumen tidak dimodifikasi, menutupnya tidak meminta pengguna untuk menyimpan.

Metode ini melemparkan pengecualian dengan makro ASSERT jika pDocument bukan objek yang valid CDocument .

Untuk menggunakan metode ini, AFX_RESTART_MANAGER_AUTOSAVE_AT_RESTART atau AFX_RESTARTMANAGER_AUTOSAVE_AT_INTERVAL harus diatur dalam m_dwRestartManagerSupportFlags.

CDataRecoveryHandler::CDataRecoveryHandler

Membuat CDataRecoveryHandler objek.

CDataRecoveryHandler(
    DWORD dwRestartManagerSupportFlags,
    int nAutosaveInterval);

Parameter

dwRestartManagerSupportFlags
[di] Menunjukkan opsi manajer hidupkan ulang mana yang didukung.

nAutosaveInterval
[di] Waktu antara penyimpanan otomatis. Parameter ini dalam milidetik.

Keterangan

Kerangka kerja MFC secara otomatis membuat CDataRecoveryHandler objek untuk aplikasi Anda saat Anda menggunakan wizard Proyek Baru. Kecuali Anda menyesuaikan perilaku pemulihan data atau manajer hidupkan ulang, Anda tidak boleh membuat CDataRecoveryHandler objek.

CDataRecoveryHandler::CreateDocumentInfo

Menambahkan dokumen ke daftar dokumen yang terbuka.

virtual BOOL CreateDocumentInfo(CDocument* pDocument);

Parameter

pDocument
[di] Penunjuk ke CDocument. Metode ini membuat informasi dokumen untuk ini CDocument.

Tampilkan Nilai

Implementasi default mengembalikan TRUE.

Keterangan

Metode ini memeriksa apakah pDocument sudah ada dalam daftar dokumen sebelum menambahkan dokumen. Jika pDocument sudah ada dalam daftar, metode ini menghapus file yang disimpan otomatis yang terkait dengan pDocument.

Untuk menggunakan metode ini, AFX_RESTART_MANAGER_AUTOSAVE_AT_RESTART atau AFX_RESTARTMANAGER_AUTOSAVE_AT_INTERVAL harus diatur dalam m_dwRestartManagerSupportFlags.

CDataRecoveryHandler::D eleteAllAutosavedFiles

Menghapus semua berkas yang disimpan otomatis saat ini.

virtual BOOL DeleteAllAutosavedFiles();

Tampilkan Nilai

Implementasi default selalu mengembalikan TRUE.

CDataRecoveryHandler::D eleteAutosavedFile

Menghapus file yang disimpan otomatis yang ditentukan.

virtual BOOL DeleteAutosavedFile(const CString& strAutosavedFile);

Parameter

strAutosavedFile
[di] String yang berisi nama file yang disimpan otomatis.

Tampilkan Nilai

Implementasi default selalu mengembalikan TRUE.

Keterangan

Jika metode ini tidak dapat menghapus file yang disimpan otomatis, metode menyimpan nama file dalam daftar. Destruktor untuk CDataRecoveryHandler mencoba menghapus setiap file yang disimpan otomatis yang ditentukan dalam daftar tersebut.

CDataRecoveryHandler::GenerateAutosaveFileName

Menghasilkan nama untuk file simpan otomatis yang terkait dengan nama file dokumen yang disediakan.

virtual CString GenerateAutosaveFileName(const CString& strDocumentName) const;

Parameter

strDocumentName
[di] String yang berisi nama dokumen. GenerateAutosaveFileName menggunakan nama dokumen ini untuk menghasilkan nama file simpan otomatis yang sesuai.

Tampilkan Nilai

Nama file simpan otomatis yang dihasilkan dari strDocumentName.

Keterangan

Setiap nama dokumen memiliki pemetaan satu-ke-satu dengan nama file simpan otomatis.

CDataRecoveryHandler::GetAutosaveInterval

Mengembalikan interval antara percobaan penyimpanan otomatis.

virtual int GetAutosaveInterval() const;

Tampilkan Nilai

Jumlah milidetik antara percobaan penyimpanan otomatis.

CDataRecoveryHandler::GetAutosavePath

Mengembalikan jalur file yang disimpan otomatis.

virtual CString GetAutosavePath() const;

Tampilkan Nilai

Lokasi penyimpanan dokumen yang disimpan secara otomatis.

CDataRecoveryHandler::GetDocumentListName

Mengambil nama dokumen dari CDocument objek.

virtual CString GetDocumentListName(CDocument* pDocument) const;

Parameter

pDocument
[di] Penunjuk ke CDocument. GetDocumentListName mengambil nama dokumen dari ini CDocument.

Tampilkan Nilai

Nama dokumen dari pDocument.

Keterangan

CDataRecoveryHandler menggunakan nama dokumen sebagai kunci di m_mapDocNameToAutosaveName, m_mapDocNameToDocumentPtr, dan m_mapDocNameToRestoreBool. Parameter ini memungkinkan CDataRecoveryHandler untuk memantau CDocument objek, menyimpan nama file secara otomatis, dan pengaturan simpan otomatis.

CDataRecoveryHandler::GetNormalDocumentTitle

Mengambil judul normal untuk dokumen yang ditentukan.

virtual CString GetNormalDocumentTitle(CDocument* pDocument);

Parameter

pDocument
[di] Penunjuk ke CDocument.

Tampilkan Nilai

Judul normal untuk dokumen yang ditentukan.

Keterangan

Judul normal dokumen biasanya adalah nama file dokumen tanpa jalur. Ini adalah judul di bidang Nama file dari kotak dialog Simpan Sebagai .

CDataRecoveryHandler::GetRecoveredDocumentTitle

Membuat dan mengembalikan judul untuk dokumen yang dipulihkan.

virtual CString GetRecoveredDocumentTitle(const CString& strDocumentTitle) const;

Parameter

strDocumentTitle
[di] Judul normal untuk dokumen.

Tampilkan Nilai

Judul dokumen yang dipulihkan.

Keterangan

Secara default, judul dokumen yang dipulihkan adalah judul normal dengan [dipulihkan] ditambahkan ke dalamnya. Judul yang dipulihkan ditampilkan kepada pengguna saat CDataRecoveryHandler pengguna meminta untuk memulihkan dokumen yang disimpan otomatis.

CDataRecoveryHandler::GetRestartIdentifier

Mengambil pengidentifikasi hidupkan ulang unik untuk aplikasi.

virtual CString GetRestartIdentifier() const;

Tampilkan Nilai

Pengidentifikasi hidupkan ulang yang unik.

Keterangan

Pengidentifikasi hidupkan ulang unik untuk setiap eksekusi aplikasi.

Menyimpan CDataRecoveryHandler informasi dalam registri tentang dokumen yang saat ini terbuka. Ketika manajer hidupkan ulang keluar dari aplikasi dan memulai ulang aplikasi, ia memasok pengidentifikasi hidupkan ulang ke CDataRecoveryHandler. CDataRecoveryHandler menggunakan pengidentifikasi hidupkan ulang untuk mengambil daftar dokumen yang dibuka sebelumnya. Ini memungkinkan CDataRecoveryHandler untuk mencoba menemukan dan memulihkan file yang disimpan otomatis.

CDataRecoveryHandler::GetSaveDocumentInfoOnIdle

Menunjukkan apakah CDataRecoveryHandler melakukan penyimpanan otomatis pada perulangan diam saat ini.

virtual BOOL GetSaveDocumentInfoOnIdle() const;

Tampilkan Nilai

TRUE menunjukkan penyimpanan CDataRecoveryHandler otomatis pada perulangan diam saat ini; FALSE menunjukkan tidak.

CDataRecoveryHandler::GetShutdownByRestartManager

Menunjukkan apakah manajer hidupkan ulang menyebabkan aplikasi keluar.

virtual BOOL GetShutdownByRestartManager() const;

Tampilkan Nilai

TRUE menunjukkan bahwa manajer hidupkan ulang menyebabkan aplikasi keluar; FALSE menunjukkan tidak.

CDataRecoveryHandler::Initialize

Menginisialisasi CDataRecoveryHandler.

virtual BOOL Initialize();

Tampilkan Nilai

TRUE jika inisialisasi berhasil; jika tidak FALSE.

Keterangan

Proses inisialisasi memuat jalur untuk menyimpan file simpan otomatis dari registri. Initialize Jika metode tidak dapat menemukan direktori ini atau jika jalurnya NULL, Initialize gagal dan mengembalikan FALSE.

Gunakan CDataRecoveryHandler::SetAutosavePath untuk mengubah jalur penyimpanan otomatis setelah aplikasi Anda menginisialisasi CDataRecoveryHandler.

Metode ini Initialize juga memulai timer untuk memantau kapan penyimpanan otomatis berikutnya terjadi. Gunakan CDataRecoveryHandler::SetAutosaveInterval untuk mengubah interval penyimpanan otomatis setelah aplikasi Anda menginisialisasi CDataRecoveryHandler.

CDataRecoveryHandler::QueryRestoreAutosavedDocuments

Menampilkan kotak dialog kepada pengguna untuk setiap dokumen yang CDataRecoveryHandler disimpan secara otomatis. Kotak dialog menentukan apakah pengguna ingin memulihkan dokumen yang disimpan otomatis.

virtual void QueryRestoreAutosavedDocuments();

Keterangan

Jika aplikasi Anda adalah Unicode, metode ini menampilkan CTaskDialog kepada pengguna. Jika tidak, kerangka kerja menggunakan AfxMessageBox untuk mengkueri pengguna.

Setelah QueryRestoreAutosavedDocuments mengumpulkan semua respons dari pengguna, ia menyimpan informasi dalam variabel anggota m_mapDocNameToRestoreBool. Metode ini tidak memulihkan dokumen yang disimpan otomatis.

CDataRecoveryHandler::ReadOpenDocumentList

Memuat daftar dokumen yang terbuka dari registri.

virtual BOOL ReadOpenDocumentList();

Tampilkan Nilai

TRUE menunjukkan bahwa ReadOpenDocumentList memuat informasi untuk setidaknya satu dokumen dari registri; FALSE menunjukkan tidak ada informasi dokumen yang dimuat.

Keterangan

Fungsi ini memuat informasi dokumen terbuka dari registri dan menyimpannya dalam variabel anggota m_mapDocNameToAutosaveName.

Setelah ReadOpenDocumentList memuat semua data, data akan menghapus informasi dokumen dari registri.

CDataRecoveryHandler::RemoveDocumentInfo

Menghapus dokumen yang disediakan dari daftar dokumen yang terbuka.

virtual BOOL RemoveDocumentInfo(CDocument* pDocument);

Parameter

pDocument
[di] Penunjuk ke dokumen yang akan dihapus.

Tampilkan Nilai

TRUE jika pDocument dihapus dari daftar; FALSE jika terjadi kesalahan.

Keterangan

Saat pengguna menutup dokumen, kerangka kerja menggunakan metode ini untuk menghapusnya dari daftar dokumen yang terbuka.

Jika RemoveDocumentInfo tidak dapat menemukan pDocument dalam daftar dokumen yang terbuka, itu tidak melakukan apa pun dan mengembalikan TRUE.

Untuk menggunakan metode ini, AFX_RESTART_MANAGER_REOPEN_PREVIOUS_FILES harus diatur dalam m_dwRestartManagerSupportFlags.

CDataRecoveryHandler::ReopenPreviousDocuments

Membuka dokumen yang dibuka sebelumnya.

virtual BOOL ReopenPreviousDocuments();

Tampilkan Nilai

TRUE jika setidaknya satu dokumen dibuka; jika tidak FALSE.

Keterangan

Metode ini membuka penyimpanan terbaru dari dokumen yang dibuka sebelumnya. Jika dokumen tidak disimpan atau disimpan secara otomatis, ReopenPreviousDocuments membuka dokumen kosong berdasarkan templat untuk jenis file tersebut.

Untuk menggunakan metode ini, AFX_RESTART_MANAGER_REOPEN_PREVIOUS_FILES harus diatur dalam m_dwRestartManagerSupportFlags. Jika parameter ini tidak diatur, ReopenPreviousDocuments tidak melakukan apa pun dan mengembalikan FALSE.

Jika tidak ada dokumen yang disimpan dalam daftar dokumen yang dibuka sebelumnya, ReopenPreviousDocuments tidak melakukan apa pun dan mengembalikan FALSE.

CDataRecoveryHandler::RestoreAutosavedDocuments

Memulihkan dokumen yang disimpan otomatis berdasarkan input pengguna.

virtual BOOL RestoreAutosavedDocuments();

Tampilkan Nilai

TRUE jika metode ini berhasil memulihkan dokumen.

Keterangan

Metode ini memanggil CDataRecoveryHandler::QueryRestoreAutosavedDocuments untuk menentukan dokumen mana yang ingin dipulihkan pengguna. Jika pengguna memutuskan untuk tidak memulihkan dokumen yang disimpan otomatis, RestoreAutosavedDocuments menghapus file simpan otomatis. Jika tidak, RestoreAutosavedDocuments mengganti dokumen yang terbuka dengan versi yang disimpan otomatis.

Untuk menggunakan metode ini, baik AFX_RESTART_MANAGER_REOPEN_PREVIOUS_FILES atau AFX_RESTART_MANAGER_RESTORE_AUTOSAVED_FILES harus diatur dalam m_dwRestartManagerSupportFlags.

CDataRecoveryHandler::SaveOpenDocumentList

Menyimpan daftar dokumen terbuka saat ini ke registri Windows.

virtual BOOL SaveOpenDocumentList();

Tampilkan Nilai

TRUE jika tidak ada dokumen yang terbuka untuk disimpan atau jika berhasil disimpan. FALSE jika ada dokumen untuk disimpan ke registri, tetapi tidak disimpan karena terjadi kesalahan.

Keterangan

Manajer mulai ulang memanggil SaveOpenDocumentList ketika aplikasi keluar secara tak terduga atau ketika keluar untuk peningkatan. Saat aplikasi dimulai ulang, aplikasi menggunakan CDataRecoveryHandler::ReadOpenDocumentList untuk mengambil daftar dokumen yang terbuka.

Metode ini hanya menyimpan daftar dokumen yang terbuka. Metode CDataRecoveryHandler::AutosaveDocumentInfo bertanggung jawab untuk menyimpan dokumen itu sendiri.

CDataRecoveryHandler::SetAutosaveInterval

Mengatur waktu antara siklus penyimpanan otomatis dalam milidetik.

Virtual void SetAutosaveInterval(int nAutosaveInterval);

Parameter

nAutosaveInterval
[di] Interval penyimpanan otomatis baru dalam milidetik.

CDataRecoveryHandler::SetAutosavePath

Mengatur direktori tempat file yang disimpan otomatis disimpan.

virtual void SetAutosavePath(const CString& strAutosavePath);

Parameter

strAutosavePath
[di] Jalur tempat file penyimpanan otomatis disimpan.

Keterangan

Mengubah direktori simpan otomatis tidak memindahkan file yang disimpan otomatis saat ini.

CDataRecoveryHandler::SetRestartIdentifier

Mengatur pengidentifikasi hidupkan ulang unik untuk instans ini dari CDataRecoveryHandler.

virtual void SetRestartIdentifier(const CString& strRestartIdentifier);

Parameter

strRestartIdentifier
[di] Pengidentifikasi unik untuk manajer hidupkan ulang.

Keterangan

Manajer mulai ulang merekam informasi tentang dokumen yang terbuka di registri. Informasi ini disimpan dengan pengidentifikasi hidupkan ulang unik sebagai kunci. Karena pengidentifikasi hidupkan ulang unik untuk setiap instans aplikasi, beberapa instans aplikasi dapat keluar secara tidak terduga dan manajer restart dapat memulihkan masing-masing aplikasi.

CDataRecoveryHandler::SetSaveDocumentInfoOnIdle

Mengatur apakah CDataRecoveryHandler menyimpan informasi dokumen terbuka ke registri Windows selama siklus menganggur saat ini.

virtual void SetSaveDocumentInfoOnIdle(BOOL bSaveOnIdle);

Parameter

bSaveOnIdle
[di] TRUE untuk menyimpan informasi dokumen selama siklus menganggur saat ini; FALSE untuk tidak melakukan penyimpanan.

CDataRecoveryHandler::SetShutdownByRestartManager

Mengatur apakah keluarnya aplikasi sebelumnya disebabkan oleh manajer hidupkan ulang.

virtual void SetShutdownByRestartManager(BOOL bShutdownByRestartManager);

Parameter

bShutdownByRestartManager
[di] TRUE untuk menunjukkan bahwa manajer hidupkan ulang menyebabkan aplikasi keluar; FALSE untuk menunjukkan bahwa aplikasi keluar karena alasan lain.

Keterangan

Kerangka kerja berperilaku berbeda berdasarkan apakah keluar sebelumnya tidak terduga atau apakah itu dimulai oleh manajer hidupkan ulang.

CDataRecoveryHandler::UpdateDocumentInfo

Memperbarui informasi untuk dokumen karena pengguna menyimpannya.

virtual BOOL UpdateDocumentInfo(CDocument* pDocument);

Parameter

pDocument
[di] Penunjuk ke dokumen yang disimpan.

Tampilkan Nilai

TRUE jika metode ini menghapus dokumen yang disimpan otomatis dan memperbarui informasi dokumen; FALSE jika terjadi kesalahan.

Keterangan

Saat pengguna menyimpan dokumen, aplikasi menghapus file yang disimpan otomatis karena tidak lagi diperlukan. UpdateDocumentInfo menghapus file yang disimpan otomatis dengan memanggil CDataRecoveryHandler::RemoveDocumentInfo. UpdateDocumentInfo kemudian menambahkan informasi dari pDocument ke daftar dokumen yang saat ini terbuka karena RemoveDocumentInfo menghapus informasi tersebut, tetapi dokumen yang disimpan masih terbuka.

Untuk menggunakan metode ini, AFX_RESTART_MANAGER_REOPEN_PREVIOUS_FILES harus diatur dalam m_dwRestartManagerSupportFlags.

Lihat juga

Kelas
Bagan Hierarki
Kelas CObject
Cara: Menambahkan Dukungan Restart Manager