CDataRecoveryHandler osztály

Megjegyzés:

A Microsoft Foundation Classes (MFC) könyvtár továbbra is támogatott. A továbbiakban azonban nem adunk hozzá funkciókat, és nem frissítjük a dokumentációt.

Az CDataRecoveryHandler automatikusan menti a dokumentumokat, és visszaállítja őket, ha egy alkalmazás váratlanul kilép.

Szemantika

class CDataRecoveryHandler : public CObject

Tagok

Konstruktorok

Név	Description
CDataRecoveryHandler::CDataRecoveryHandler	Egy CDataRecoveryHandler objektumot hoz létre.

Methods

Név	Description
CDataRecoveryHandler::AutosaveAllDocumentInfo	Automatikusan menti az CDataRecoveryHandler osztályban regisztrált összes fájlt.
CDataRecoveryHandler::AutosaveDocumentInfo	A megadott dokumentum automatikus mentése.
CDataRecoveryHandler::CreateDocumentInfo	Hozzáad egy dokumentumot a megnyitott dokumentumok listájához.
CDataRecoveryHandler::D eleteAllAutosavedFiles	Törli az összes aktuális automatikusan mentett fájlt.
CDataRecoveryHandler::D eleteAutosavedFile	Törli a megadott automatikusan mentett fájlt.
CDataRecoveryHandler::GenerateAutosaveFileName	Létrehozza a megadott dokumentumfájl nevével társított automatikus mentési fájl nevét.
CDataRecoveryHandler::GetAutosaveInterval	Az automatikus mentési próbálkozások közötti időközt adja vissza.
CDataRecoveryHandler::GetAutosavePath	Az automatikusan mentett fájlok elérési útját adja vissza.
CDataRecoveryHandler::GetDocumentListName	Lekéri a dokumentum nevét egy CDocument objektumból.
CDataRecoveryHandler::GetNormalDocumentTitle	A megadott dokumentum normál címét kéri le.
CDataRecoveryHandler::GetRecoveredDocumentTitle	Létrehozza és visszaadja a helyreállított dokumentum címét.
CDataRecoveryHandler::GetRestartIdentifier	Az alkalmazás egyedi újraindítási azonosítójának lekérése.
CDataRecoveryHandler::GetSaveDocumentInfoOnIdle	Azt jelzi, hogy a CDataRecoveryHandler folyamat automatikus mentést végez-e az aktuális tétlen cikluson.
CDataRecoveryHandler::GetShutdownByRestartManager	Azt jelzi, hogy az újraindítás-kezelő okozta-e az alkalmazás kilépését.
CDataRecoveryHandler::Initialize	Inicializálja a CDataRecoveryHandler.
CDataRecoveryHandler::QueryRestoreAutosavedDocuments	Megjeleníti az automatikusan mentett dokumentumokhoz tartozó párbeszédpanelt a CDataRecoveryHandler felhasználónak. A párbeszédpanel meghatározza, hogy a felhasználó vissza szeretné-e állítani az automatikusan mentett dokumentumot.
CDataRecoveryHandler::ReadOpenDocumentList	Betölti a megnyitott dokumentumlistát a beállításjegyzékből.
CDataRecoveryHandler::RemoveDocumentInfo	Eltávolítja a megadott dokumentumot a megnyitott dokumentumlistáról.
CDataRecoveryHandler::ReopenPreviousDocuments	Megnyitja a korábban megnyitott dokumentumokat.
CDataRecoveryHandler::RestoreAutosavedDocuments	Visszaállítja az automatikusan mentett dokumentumokat a felhasználói bemenet alapján.
CDataRecoveryHandler::SaveOpenDocumentList	Menti a megnyitott dokumentumok aktuális listáját a Windows-beállításjegyzékbe.
CDataRecoveryHandler::SetAutosaveInterval	Ezredmásodpercben állítja be az automatikus mentési ciklusok közötti időt.
CDataRecoveryHandler::SetAutosavePath	Beállítja az automatikusan mentett fájlok tárolására szolgáló könyvtárat.
CDataRecoveryHandler::SetRestartIdentifier	Beállítja a példány egyedi újraindítási azonosítóját CDataRecoveryHandler.
CDataRecoveryHandler::SetSaveDocumentInfoOnIdle	Beállítja, hogy a CDataRecoveryHandler megnyitott dokumentum adatai a windowsos beállításjegyzékbe legyenek-e mentve az aktuális tétlenségi ciklus során.
CDataRecoveryHandler::SetShutdownByRestartManager	Beállítja, hogy az alkalmazás előző kilépését az újraindítás-kezelő okozta-e.
CDataRecoveryHandler::UpdateDocumentInfo	Frissíti a dokumentum adatait, mert a felhasználó mentette.

Adattagok

Név	Description
m_bRestoringPreviousOpenDocs	Azt jelzi, hogy az adat-helyreállítási kezelő újra megnyitja-e a korábban megnyitott dokumentumokat.
m_bSaveDocumentInfoOnIdle	Azt jelzi, hogy az adat-helyreállítási kezelő automatikusan mentette-e a dokumentumokat a következő tétlen ciklusban.
m_bShutdownByRestartManager	Azt jelzi, hogy az újraindítás-kezelő okozza-e az alkalmazás kilépését.
m_dwRestartManagerSupportFlags	Jelzők, amelyek jelzik, hogy az újraindítás-kezelő milyen támogatást biztosít az alkalmazás számára.
m_lstAutosavesToDelete	Az automatikusan mentett fájlok listája, amelyeket az eredeti dokumentumok bezárásakor nem töröltek. Amikor az alkalmazás kilép, az újraindítás-kezelő újra megismétli a fájlok törlését.
m_mapDocNameToAutosaveName	A dokumentumnevek térképe az automatikusan mentett fájlnevekre.
m_mapDocNameToDocumentPtr	A dokumentumnevek térképe a CDocument mutatóihoz.
m_mapDocNameToRestoreBool	A dokumentumnevek leképezése logikai paraméterre, amely jelzi, hogy visszaállítja-e az automatikusan mentett dokumentumot.
m_mapDocumentPtrToDocName	A dokumentumnevekre mutató mutatók térképe CDocument .
m_mapDocumentPtrToDocTitle	A dokumentumcímek mutatóinak térképe CDocument . Ezek a címek fájlok mentésére szolgálnak.
m_nAutosaveInterval	Az automatikus mentések közötti idő ezredmásodpercben.
m_nTimerID	Az automatikus mentés időzítőjének azonosítója.
m_strAutosavePath	Az automatikusan mentett dokumentumok tárolási helye.
m_strRestartIdentifier	Az újraindítás-kezelő GUID-azonosítójának sztring-ábrázolása.

Megjegyzések

Az újraindítás-kezelő az osztály használatával nyomon követi az CDataRecoveryHandler összes megnyitott dokumentumot, és szükség szerint automatikusan menti őket. Az automatikus mentés engedélyezéséhez használja a CDataRecoveryHandler::SetSaveDocumentInfoOnIdle metódust. Ezzel a módszerrel automatikus CDataRecoveryHandler mentést hajthat végre a következő tétlen ciklusban. Az újraindítás-kezelő meghívja SetSaveDocumentInfoOnIdle , ha az CDataRecoveryHandler automatikus mentést végre kell hajtania.

Az osztály összes metódusa CDataRecoveryHandler virtuális. Az osztály metódusainak felülbírálása saját egyéni adat-helyreállítási kezelő létrehozásához. Ha nem hoz létre saját adat-helyreállítási kezelőt vagy újraindításkezelőt, ne hozzon létre CDataRecoveryHandlert. A CWinApp-osztály szükség szerint létrehoz egy CDataRecoveryHandler objektumot.

Mielőtt használni tud egy objektumot CDataRecoveryHandler , hívja meg a CDataRecoveryHandler::Initialize parancsot.

Mivel az CDataRecoveryHandler osztály szorosan kapcsolódik az újraindítás-kezelőhöz, CDataRecoveryHandler a globális paramétertől m_dwRestartManagerSupportFlagsfügg. Ez a paraméter határozza meg, hogy az újraindítás-kezelő milyen engedélyekkel rendelkezik, és hogyan kommunikál az alkalmazással. Az újraindításkezelő meglévő alkalmazásba való beépítéséhez hozzá kell rendelnie m_dwRestartManagerSupportFlags a megfelelő értéket a főalkalmazás konstruktorában. Az újraindításkezelő használatáról további információt a How to: Add Restart Manager Support (Újraindításkezelő támogatása) című témakörben talál.

Requirements

Fejléc: afxdatarecovery.h

CDataRecoveryHandler::AutosaveAllDocumentInfo

Automatikusan menti az CDataRecoveryHandler osztályban regisztrált összes fájlt.

virtual BOOL AutosaveAllDocumentInfo();

Visszaadott érték

IGAZ, ha az CDataRecoveryHandler összes dokumentumot mentette; HAMIS, ha egyik dokumentumot sem mentette.

Megjegyzések

Ez a metódus IGAZ értéket ad vissza, ha nincsenek mentendő dokumentumok. Igaz értéket is ad vissza a dokumentumok mentése nélkül, ha az alkalmazás vagy CDocManager az CWinApp alkalmazás beolvasása hibát okoz.

A metódus használatához be kell állítani m_dwRestartManagerSupportFlagsAFX_RESTART_MANAGER_AUTOSAVE_AT_RESTART vagy AFX_RESTART_MANAGER_AUTOSAVE_AT_INTERVAL. További információ : How to: Add Restart Manager Support.

CDataRecoveryHandler::AutosaveDocumentInfo

A megadott dokumentum automatikus mentése.

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

Paraméterek

pDocument
[in] A mentéshez mutató CDocument mutató.

bResetModifiedFlag
[in] A TRUE azt jelzi, hogy a CDataRecoveryHandlerpDocument módosításra kerül; A HAMIS azt jelzi, hogy a keretrendszer a pDocumentet módosítatlannak tekinti. A jelölő hatásával kapcsolatos további információkért tekintse meg a Megjegyzések szakaszt.

Visszaadott érték

IGAZ, ha a megfelelő jelzők be vannak állítva, és a pDocument egy érvényes CDocument objektum.

Megjegyzések

Minden CDocument objektumnak van egy jelölője, amely jelzi, hogy megváltozott-e az utolsó mentés óta. Használja a CDocument::IsModified parancsot a jelölő állapotának meghatározásához. Ha egy CDocument fájl nem változott az utolsó mentés óta, AutosaveDocumentInfo törli a dokumentum automatikusan mentett fájljait. Ha egy dokumentum az utolsó mentés óta módosult, a lezárás azt kéri a felhasználótól, hogy a záró előtt mentse a dokumentumot.

Megjegyzés:

Ha a bResetModifiedFlag használatával módosítja a dokumentum állapotát módosítatlanra, a felhasználó elveszítheti a nem mentett adatokat. Ha a keretrendszer módosítatlannak tekint egy dokumentumot, a bezárása nem kéri a felhasználót a mentésre.

Ez a metódus kivételt jelent az ASSERT makróval, ha a pDocument nem érvényes CDocument objektum.

A módszer használatához AFX_RESTART_MANAGER_AUTOSAVE_AT_RESTART vagy AFX_RESTARTMANAGER_AUTOSAVE_AT_INTERVAL kell beállítani m_dwRestartManagerSupportFlags.

CDataRecoveryHandler::CDataRecoveryHandler

Egy CDataRecoveryHandler objektumot hoz létre.

CDataRecoveryHandler(
    DWORD dwRestartManagerSupportFlags,
    int nAutosaveInterval);

Paraméterek

dwRestartManagerSupportFlags
[in] Azt jelzi, hogy az újraindítás-kezelő mely beállításai támogatottak.

nAutosaveInterval
[in] Az automatikus mentések közötti idő. Ez a paraméter ezredmásodpercben van.

Megjegyzések

Az MFC-keretrendszer automatikusan létrehoz egy CDataRecoveryHandler objektumot az alkalmazás számára az Új projekt varázsló használatakor. Hacsak nem szabja testre az adat-helyreállítási viselkedést vagy az újraindítás-kezelőt, ne hozzon létre objektumot CDataRecoveryHandler .

CDataRecoveryHandler::CreateDocumentInfo

Hozzáad egy dokumentumot a megnyitott dokumentumok listájához.

virtual BOOL CreateDocumentInfo(CDocument* pDocument);

Paraméterek

pDocument
[in] Mutató egy CDocument. Ez a metódus létrehozza ennek a dokumentumnak a dokumentumadatait CDocument.

Visszaadott érték

Az alapértelmezett implementáció IGAZ értéket ad vissza.

Megjegyzések

Ez a módszer ellenőrzi, hogy a pDocument már szerepel-e a dokumentumok listájában, mielőtt hozzáadja a dokumentumot. Ha a pDocument már szerepel a listában, ez a metódus törli a pDocumenthez társított automatikusan mentett fájlt.

A módszer használatához AFX_RESTART_MANAGER_AUTOSAVE_AT_RESTART vagy AFX_RESTARTMANAGER_AUTOSAVE_AT_INTERVAL kell beállítani m_dwRestartManagerSupportFlags.

CDataRecoveryHandler::D eleteAllAutosavedFiles

Törli az összes aktuális automatikusan mentett fájlt.

virtual BOOL DeleteAllAutosavedFiles();

Visszaadott érték

Az alapértelmezett implementáció mindig IGAZ értéket ad vissza.

CDataRecoveryHandler::D eleteAutosavedFile

Törli a megadott automatikusan mentett fájlt.

virtual BOOL DeleteAutosavedFile(const CString& strAutosavedFile);

Paraméterek

strAutosavedFile
[in] Az automatikusan mentett fájlnevet tartalmazó sztring.

Visszaadott érték

Az alapértelmezett implementáció mindig IGAZ értéket ad vissza.

Megjegyzések

Ha ez a metódus nem tudja törölni az automatikusan mentett fájlt, a fájl nevét menti egy listában. A lista összes automatikusan mentett fájljának törlésére CDataRecoveryHandler szolgáló destruktor.

CDataRecoveryHandler::GenerateAutosaveFileName

Létrehozza a megadott dokumentumfájl nevével társított automatikus mentési fájl nevét.

virtual CString GenerateAutosaveFileName(const CString& strDocumentName) const;

Paraméterek

strDocumentName
[in] A dokumentum nevét tartalmazó sztring. GenerateAutosaveFileName ezzel a dokumentumnévvel hozza létre a megfelelő automatikus mentési fájlnevet.

Visszaadott érték

A strDocumentName fájlnévből létrehozott automatikus mentési fájlnév.

Megjegyzések

Minden dokumentumnév egy-az-egyhez leképezéssel rendelkezik, automatikus mentési fájlnévvel.

CDataRecoveryHandler::GetAutosaveInterval

Az automatikus mentési próbálkozások közötti időközt adja vissza.

virtual int GetAutosaveInterval() const;

Visszaadott érték

Az automatikus mentési próbálkozások közötti ezredmásodpercek száma.

CDataRecoveryHandler::GetAutosavePath

Az automatikusan mentett fájlok elérési útját adja vissza.

virtual CString GetAutosavePath() const;

Visszaadott érték

Az automatikusan mentett dokumentumok tárolási helye.

CDataRecoveryHandler::GetDocumentListName

Lekéri a dokumentum nevét egy CDocument objektumból.

virtual CString GetDocumentListName(CDocument* pDocument) const;

Paraméterek

pDocument
[in] Mutató egy CDocument. GetDocumentListName ebből a dokumentumnévből kéri le a CDocumentdokumentumot.

Visszaadott érték

A dokumentum neve a pDocumentből.

Megjegyzések

A CDataRecoveryHandler dokumentum nevét használja kulcsként m_mapDocNameToAutosaveName,m_mapDocNameToDocumentPtr és m_mapDocNameToRestoreBool. Ezek a paraméterek lehetővé teszik az CDataRecoveryHandler objektumok monitorozását CDocument , az automatikus mentés fájlnevét és az automatikus mentési beállításokat.

CDataRecoveryHandler::GetNormalDocumentTitle

A megadott dokumentum normál címét kéri le.

virtual CString GetNormalDocumentTitle(CDocument* pDocument);

Paraméterek

pDocument
[in] Mutató egy CDocument.

Visszaadott érték

A megadott dokumentum normál címe.

Megjegyzések

A dokumentum normál címe általában a dokumentum fájlneve, elérési út nélkül. Ez a cím a Mentés másként párbeszédpanel Fájlnév mezőjében.

CDataRecoveryHandler::GetRecoveredDocumentTitle

Létrehozza és visszaadja a helyreállított dokumentum címét.

virtual CString GetRecoveredDocumentTitle(const CString& strDocumentTitle) const;

Paraméterek

strDocumentTitle
[in] A dokumentum normál címe.

Visszaadott érték

A helyreállított dokumentum címe.

Megjegyzések

Alapértelmezés szerint a dokumentum helyreállított címe a szokásos cím, amelyhez hozzá van fűzve a [helyreállítva] felirat. A helyreállított cím akkor jelenik meg a felhasználó számára, amikor a felhasználó lekérdezi CDataRecoveryHandler az automatikusan mentett dokumentumok visszaállítását.

CDataRecoveryHandler::GetRestartIdentifier

Az alkalmazás egyedi újraindítási azonosítójának lekérése.

virtual CString GetRestartIdentifier() const;

Visszaadott érték

Az egyedi újraindítási azonosító.

Megjegyzések

Az újraindítás azonosítója egyedi az alkalmazás minden egyes végrehajtásához.

A CDataRecoveryHandler beállításjegyzékben az aktuálisan megnyitott dokumentumokra vonatkozó információkat tárolja. Amikor az újraindítás-kezelő kilép egy alkalmazásból, és újraindítja azt, megadja az újraindítás azonosítót a CDataRecoveryHandler. A CDataRecoveryHandler rendszer az újraindítási azonosítót használja a korábban megnyitott dokumentumok listájának lekéréséhez. Ez lehetővé teszi az CDataRecoveryHandler automatikusan mentett fájlok keresését és visszaállítását.

CDataRecoveryHandler::GetSaveDocumentInfoOnIdle

Azt jelzi, hogy a CDataRecoveryHandler folyamat automatikus mentést végez-e az aktuális tétlen cikluson.

virtual BOOL GetSaveDocumentInfoOnIdle() const;

Visszaadott érték

A TRUE az CDataRecoveryHandler aktuális tétlen ciklus automatikus mentéseit jelzi; A HAMIS azt jelzi, hogy nem.

CDataRecoveryHandler::GetShutdownByRestartManager

Azt jelzi, hogy az újraindítás-kezelő okozta-e az alkalmazás kilépését.

virtual BOOL GetShutdownByRestartManager() const;

Visszaadott érték

AZ IGAZ érték azt jelzi, hogy az újraindítás-kezelő miatt az alkalmazás kilépett; A HAMIS azt jelzi, hogy nem.

CDataRecoveryHandler::Initialize

Inicializálja a CDataRecoveryHandler.

virtual BOOL Initialize();

Visszaadott érték

IGAZ, ha az inicializálás sikeres; egyéb esetben HAMIS.

Megjegyzések

Az inicializálási folyamat betölti a fájlok automatikus mentésének elérési útját a beállításjegyzékből. Ha a metódus nem találja ezt a Initialize könyvtárat, vagy ha az elérési út NULL, meghiúsul, Initialize és visszaadja FALSE.

Használja a CDataRecoveryHandler::SetAutosavePath parancsot az automatikus mentési útvonal módosításához, miután az alkalmazás inicializálja a CDataRecoveryHandler.

A Initialize metódus egy időzítőt is elindít, amely figyeli, hogy mikor következik be a következő automatikus mentés. Használja a CDataRecoveryHandler::SetAutosaveInterval parancsot az automatikus mentési időköz módosításához, miután az alkalmazás inicializálja a CDataRecoveryHandler.

CDataRecoveryHandler::QueryRestoreAutosavedDocuments

Megjeleníti az automatikusan mentett dokumentumokhoz tartozó párbeszédpanelt a CDataRecoveryHandler felhasználónak. A párbeszédpanel meghatározza, hogy a felhasználó vissza szeretné-e állítani az automatikusan mentett dokumentumot.

virtual void QueryRestoreAutosavedDocuments();

Megjegyzések

Ha az alkalmazás Unicode, ez a metódus egy CTaskDialogot jelenít meg a felhasználónak. Ellenkező esetben a keretrendszer az AfxMessageBox használatával kérdezi le a felhasználót.

Miután QueryRestoreAutosavedDocuments összegyűjtötte a felhasználó összes válaszát, az adatokat a m_mapDocNameToRestoreBool tagváltozóban tárolja. Ez a módszer nem állítja vissza az automatikusan mentett dokumentumokat.

CDataRecoveryHandler::ReadOpenDocumentList

Betölti a megnyitott dokumentumlistát a beállításjegyzékből.

virtual BOOL ReadOpenDocumentList();

Visszaadott érték

A TRUE azt jelzi, hogy ReadOpenDocumentList legalább egy dokumentum adatait betöltötte a beállításjegyzékből; A HAMIS azt jelzi, hogy nem töltődött be dokumentuminformáció.

Megjegyzések

Ez a függvény betölti a megnyitott dokumentum adatait a beállításjegyzékből, és a m_mapDocNameToAutosaveName tagváltozóban tárolja.

Az összes adat betöltése után ReadOpenDocumentList törli a dokumentumadatokat a beállításjegyzékből.

CDataRecoveryHandler::RemoveDocumentInfo

Eltávolítja a megadott dokumentumot a megnyitott dokumentumlistáról.

virtual BOOL RemoveDocumentInfo(CDocument* pDocument);

Paraméterek

pDocument
[in] Az eltávolítandó dokumentumra mutató mutató.

Visszaadott érték

IGAZ, ha a pDocument el lett távolítva a listából; HAMIS, ha hiba történt.

Megjegyzések

Amikor a felhasználó bezár egy dokumentumot, a keretrendszer ezzel a módszerrel távolítja el a megnyitott dokumentumok listájából.

Ha RemoveDocumentInfo nem található a pDocument a megnyitott dokumentumok listájában, akkor nem tesz semmit, és IGAZ értéket ad vissza.

A módszer használatához AFX_RESTART_MANAGER_REOPEN_PREVIOUS_FILES be kell állítani m_dwRestartManagerSupportFlags.

CDataRecoveryHandler::ReopenPreviousDocuments

Megnyitja a korábban megnyitott dokumentumokat.

virtual BOOL ReopenPreviousDocuments();

Visszaadott érték

IGAZ, ha legalább egy dokumentum meg van nyitva; egyéb esetben HAMIS.

Megjegyzések

Ez a metódus megnyitja a korábban megnyitott dokumentumok legutóbbi mentését. Ha egy dokumentumot nem mentettek vagy mentettek automatikusan, ReopenPreviousDocuments az adott fájltípus sablonja alapján nyit meg egy üres dokumentumot.

A módszer használatához AFX_RESTART_MANAGER_REOPEN_PREVIOUS_FILES be kell állítani m_dwRestartManagerSupportFlags. Ha ez a paraméter nincs beállítva, nem végez semmit, ReopenPreviousDocuments és HAMIS értéket ad vissza.

Ha nincsenek a korábban megnyitott dokumentumok listájában tárolt dokumentumok, nem tesz semmit, ReopenPreviousDocuments és HAMIS értéket ad vissza.

CDataRecoveryHandler::RestoreAutosavedDocuments

Visszaállítja az automatikusan mentett dokumentumokat a felhasználói bemenet alapján.

virtual BOOL RestoreAutosavedDocuments();

Visszaadott érték

IGAZ, ha ez a módszer sikeresen visszaállítja a dokumentumokat.

Megjegyzések

Ez a metódus meghívja a CDataRecoveryHandler::QueryRestoreAutosavedDocuments parancsot annak meghatározásához, hogy a felhasználó mely dokumentumokat szeretné visszaállítani. Ha egy felhasználó úgy dönt, hogy nem állítja vissza az automatikusan mentett dokumentumot, RestoreAutosavedDocuments törli az automatikus mentési fájlt. RestoreAutosavedDocuments Ellenkező esetben lecseréli a megnyitott dokumentumot az automatikusan mentett verzióra.

A metódus használatához be kell állítani m_dwRestartManagerSupportFlagsAFX_RESTART_MANAGER_REOPEN_PREVIOUS_FILES vagy AFX_RESTART_MANAGER_RESTORE_AUTOSAVED_FILES.

CDataRecoveryHandler::SaveOpenDocumentList

Menti a megnyitott dokumentumok aktuális listáját a Windows-beállításjegyzékbe.

virtual BOOL SaveOpenDocumentList();

Visszaadott érték

IGAZ, ha nincsenek mentendő megnyitott dokumentumok, vagy ha sikeresen mentették őket. HAMIS, ha vannak olyan dokumentumok, amelyeket menteni szeretne a beállításjegyzékbe, de a rendszer nem mentette őket hiba miatt.

Megjegyzések

Az újraindítás-kezelő meghívja SaveOpenDocumentList , ha az alkalmazás váratlanul kilép, vagy amikor egy frissítéshez kilép. Amikor az alkalmazás újraindul, a CDataRecoveryHandler::ReadOpenDocumentList használatával kéri le a megnyitott dokumentumok listáját.

Ez a metódus csak a megnyitott dokumentumok listáját menti. A CDataRecoveryHandler::AutosaveDocumentInfo metódus felelős a dokumentumok maguknak a mentéséért.

CDataRecoveryHandler::SetAutosaveInterval

Ezredmásodpercben állítja be az automatikus mentési ciklusok közötti időt.

Virtual void SetAutosaveInterval(int nAutosaveInterval);

Paraméterek

nAutosaveInterval
[in] Az új automatikus mentési időköz ezredmásodpercben.

CDataRecoveryHandler::SetAutosavePath

Beállítja az automatikusan mentett fájlok tárolására szolgáló könyvtárat.

virtual void SetAutosavePath(const CString& strAutosavePath);

Paraméterek

strAutosavePath
[in] A fájlok automatikus mentésének elérési útja.

Megjegyzések

Az automatikus mentési könyvtár módosítása nem helyezi át az automatikusan mentett fájlokat.

CDataRecoveryHandler::SetRestartIdentifier

Beállítja a példány egyedi újraindítási azonosítóját CDataRecoveryHandler.

virtual void SetRestartIdentifier(const CString& strRestartIdentifier);

Paraméterek

strRestartIdentifier
[in] Az újraindítás-kezelő egyedi azonosítója.

Megjegyzések

Az újraindítás-kezelő rögzíti a beállításjegyzékben megnyitott dokumentumok adatait. Ezt az információt kulcsként az egyedi újraindítási azonosító tárolja. Mivel az újraindítási azonosító egyedi egy alkalmazás minden példányához, előfordulhat, hogy egy alkalmazás több példánya váratlanul kilép, és az újraindítás-kezelő helyre tudja állítani őket.

CDataRecoveryHandler::SetSaveDocumentInfoOnIdle

Beállítja, hogy a CDataRecoveryHandler megnyitott dokumentum adatai a windowsos beállításjegyzékbe legyenek-e mentve az aktuális tétlenségi ciklus során.

virtual void SetSaveDocumentInfoOnIdle(BOOL bSaveOnIdle);

Paraméterek

bSaveOnIdle
[in] IGAZ a dokumentumadatok mentéséhez az aktuális tétlen ciklus során; HAMIS, ha nem végez mentést.

CDataRecoveryHandler::SetShutdownByRestartManager

Beállítja, hogy az alkalmazás előző kilépését az újraindítás-kezelő okozta-e.

virtual void SetShutdownByRestartManager(BOOL bShutdownByRestartManager);

Paraméterek

bShutdownByRestartManager
[in] IGAZ, amely azt jelzi, hogy az újraindítás-kezelő miatt az alkalmazás kilépett; HAMIS, amely azt jelzi, hogy az alkalmazás más okból lépett ki.

Megjegyzések

A keretrendszer eltérően viselkedik attól függően, hogy az előző kilépés váratlan volt-e, vagy az újraindítás-kezelő kezdeményezte.

CDataRecoveryHandler::UpdateDocumentInfo

Frissíti a dokumentum adatait, mert a felhasználó mentette.

virtual BOOL UpdateDocumentInfo(CDocument* pDocument);

Paraméterek

pDocument
[in] Mutató a mentett dokumentumra.

Visszaadott érték

IGAZ, ha ez a módszer törölte az automatikusan mentett dokumentumot, és frissítette a dokumentum adatait; HAMIS, ha hiba történt.

Megjegyzések

Amikor egy felhasználó menti a dokumentumot, az alkalmazás eltávolítja az automatikusan mentett fájlt, mert már nincs rá szükség. UpdateDocumentInfo törli az automatikusan mentett fájlt a CDataRecoveryHandler::RemoveDocumentInfo hívásával. UpdateDocumentInfo ezután hozzáadja a pDocumentből származó adatokat az aktuálisan megnyitott dokumentumok listájához, mert RemoveDocumentInfo törli az adatokat, de a mentett dokumentum továbbra is nyitva van.

A módszer használatához AFX_RESTART_MANAGER_REOPEN_PREVIOUS_FILES be kell állítani m_dwRestartManagerSupportFlags.

Lásd még

osztályok
hierarchiadiagram
CObject osztály
Útmutató: Restart Manager támogatási hozzáadása