Share via

Klasse CDataRecoveryHandler

Opmerking

De Microsoft Foundation Classes-bibliotheek (MFC) wordt nog steeds ondersteund. We voegen echter geen functies meer toe of werken de documentatie bij.

De CDataRecoveryHandler documenten worden automatisch opgevraagd en hersteld als een toepassing onverwacht wordt afgesloten.

Syntaxis

class CDataRecoveryHandler : public CObject

Leden

Constructeurs

Naam Description
CDataRecoveryHandler::CDataRecoveryHandler Maakt een CDataRecoveryHandler object.

Methods

Naam Description
CDataRecoveryHandler::AutosaveAllDocumentInfo Elk bestand dat bij de CDataRecoveryHandler klasse is geregistreerd, wordt automatisch opgeslagen.
CDataRecoveryHandler::AutosaveDocumentInfo Hiermee wordt het opgegeven document automatisch opsave.
CDataRecoveryHandler::CreateDocumentInfo Hiermee voegt u een document toe aan de lijst met geopende documenten.
CDataRecoveryHandler::D eleteAllAutosavedFiles Hiermee verwijdert u alle huidige automatisch opgeslagen bestanden.
CDataRecoveryHandler::D eleteAutosavedFile Hiermee verwijdert u het opgegeven automatisch opgeslagen bestand.
CDataRecoveryHandler::GenerateAutosaveFileName Hiermee wordt de naam gegenereerd voor een automatisch opslaan-bestand dat is gekoppeld aan de opgegeven documentbestandsnaam.
CDataRecoveryHandler::GetAutosaveInterval Retourneert het interval tussen pogingen voor automatisch opslaan.
CDataRecoveryHandler::GetAutosavePath Retourneert het pad van de automatisch opgeslagen bestanden.
CDataRecoveryHandler::GetDocumentListName Haalt de documentnaam op uit een CDocument object.
CDataRecoveryHandler::GetNormalDocumentTitle Haalt de normale titel voor het opgegeven document op.
CDataRecoveryHandler::GetRecoveredDocumentTitle Hiermee maakt en retourneert u de titel voor het herstelde document.
CDataRecoveryHandler::GetRestartIdentifier Haalt de unieke herstart-id voor de toepassing op.
CDataRecoveryHandler::GetSaveDocumentInfoOnIdle Hiermee wordt aangegeven of automatisch CDataRecoveryHandler opslaan op de huidige niet-actieve lus wordt uitgevoerd.
CDataRecoveryHandler::GetShutdownByRestartManager Hiermee wordt aangegeven of de manager voor opnieuw opstarten ervoor heeft gezorgd dat de toepassing werd afgesloten.
CDataRecoveryHandler::Initialize Initialiseert de CDataRecoveryHandler.
CDataRecoveryHandler::QueryRestoreAutosavedDocuments Geeft een dialoogvenster weer aan de gebruiker voor elk document dat automatisch CDataRecoveryHandler is opgeslagen. Het dialoogvenster bepaalt of de gebruiker het automatisch opgeslagen document wil herstellen.
CDataRecoveryHandler::ReadOpenDocumentList Laadt de lijst met geopende documenten uit het register.
CDataRecoveryHandler::RemoveDocumentInfo Hiermee verwijdert u het opgegeven document uit de lijst met geopende documenten.
CDataRecoveryHandler::ReopenPreviousDocuments Hiermee opent u de eerder geopende documenten.
CDataRecoveryHandler::RestoreAutosavedDocuments Hiermee worden de automatisch opgeslagen documenten hersteld op basis van gebruikersinvoer.
CDataRecoveryHandler::SaveOpenDocumentList Hiermee wordt de huidige lijst met geopende documenten opgeslagen in het Windows-register.
CDataRecoveryHandler::SetAutosaveInterval Hiermee stelt u de tijd tussen automatisch opslaan cycli in milliseconden in.
CDataRecoveryHandler::SetAutosavePath Hiermee stelt u de map in waarin automatisch opgeslagen bestanden worden opgeslagen.
CDataRecoveryHandler::SetRestartIdentifier Hiermee stelt u de unieke id voor opnieuw opstarten in voor dit exemplaar van de CDataRecoveryHandler.
CDataRecoveryHandler::SetSaveDocumentInfoOnIdle Hiermee stelt u in of de CDataRecoveryHandler geopende documentgegevens tijdens de huidige niet-actieve cyclus in het Windows-register worden opgeslagen.
CDataRecoveryHandler::SetShutdownByRestartManager Hiermee stelt u in of de vorige exit van de toepassing is veroorzaakt door de manager voor opnieuw opstarten.
CDataRecoveryHandler::UpdateDocumentInfo Hiermee wordt de informatie voor een document bijgewerkt omdat de gebruiker het document heeft opgeslagen.

Gegevensleden

Naam Description
m_bRestoringPreviousOpenDocs Geeft aan of de handler voor gegevensherstel eerder geopende documenten opnieuw opent.
m_bSaveDocumentInfoOnIdle Geeft aan of de handler voor gegevensherstel documenten automatisch opslaat in de volgende inactieve lus.
m_bShutdownByRestartManager Geeft aan of de manager voor opnieuw opstarten ervoor zorgt dat de toepassing wordt afgesloten.
m_dwRestartManagerSupportFlags Vlaggen die aangeven welke ondersteuning de manager voor opnieuw opstarten biedt voor de toepassing.
m_lstAutosavesToDelete Een lijst met automatisch opgeslagen bestanden die niet zijn verwijderd toen de oorspronkelijke documenten werden gesloten. Wanneer de toepassing wordt afgesloten, probeert de manager de bestanden opnieuw te verwijderen.
m_mapDocNameToAutosaveName Een kaart van de documentnamen aan de automatisch opgeslagen bestandsnamen.
m_mapDocNameToDocumentPtr Een kaart van de documentnamen naar de CDocument-aanwijzers .
m_mapDocNameToRestoreBool Een kaart van de documentnamen naar een Booleaanse parameter die aangeeft of het automatisch opgeslagen document moet worden hersteld.
m_mapDocumentPtrToDocName Een kaart van de CDocument aanwijzers naar de documentnamen.
m_mapDocumentPtrToDocTitle Een kaart van de CDocument aanwijzers naar de documenttitels. Deze titels worden gebruikt voor het opslaan van bestanden.
m_nAutosaveInterval Tijd in milliseconden tussen automatisch opslaan.
m_nTimerID De id voor de timer voor automatisch opslaan.
m_strAutosavePath De locatie waar de automatisch opgeslagen documenten worden opgeslagen.
m_strRestartIdentifier De tekenreeksweergave van een GUID voor het opnieuw opstarten van manager.

Opmerkingen

De manager voor opnieuw opstarten gebruikt de CDataRecoveryHandler klasse om alle geopende documenten bij te houden en deze indien nodig automatisch op te slaan. Als u automatisch opslaan wilt inschakelen, gebruikt u de methode CDataRecoveryHandler::SetSaveDocumentInfoOnIdle . Met deze methode wordt de opdracht om CDataRecoveryHandler automatisch opslaan uit te voeren op de volgende niet-actieve lus. De manager voor opnieuw opstarten roept aan SetSaveDocumentInfoOnIdle wanneer automatisch CDataRecoveryHandler opslaan moet worden uitgevoerd.

Alle methoden van de CDataRecoveryHandler klasse zijn virtueel. Overschrijf de methoden in deze klasse om uw eigen aangepaste handler voor gegevensherstel te maken. Tenzij u uw eigen handler voor gegevensherstel of opnieuw opstarten manager maakt, moet u geen CDataRecoveryHandler instantiëren. De CWinApp-klasse maakt een CDataRecoveryHandler object zoals dit vereist is.

Voordat u een CDataRecoveryHandler object kunt gebruiken, moet u CDataRecoveryHandler::Initialize aanroepen.

Omdat de CDataRecoveryHandler klasse nauw is verbonden met de manager voor opnieuw opstarten, CDataRecoveryHandler is dit afhankelijk van de globale parameter m_dwRestartManagerSupportFlags. Deze parameter bepaalt welke machtigingen de manager voor opnieuw opstarten heeft en hoe deze communiceert met uw toepassing. Als u de manager voor opnieuw opstarten wilt opnemen in een bestaande toepassing, moet u de juiste waarde toewijzen m_dwRestartManagerSupportFlags in de constructor van uw hoofdtoepassing. Zie How to: Add Restart Manager Support (Ondersteuning voor Opnieuw opstarten beheren toevoegen) voor meer informatie over het gebruik van de manager voor opnieuw opstarten.

Requirements

Header: afxdatarecovery.h

CDataRecoveryHandler::AutosaveAllDocumentInfo

Elk bestand dat bij de CDataRecoveryHandler klasse is geregistreerd, wordt automatisch opgeslagen.

virtual BOOL AutosaveAllDocumentInfo();

Retourwaarde

WAAR als alle CDataRecoveryHandler documenten zijn opgeslagen; ONWAAR als er geen document is opgeslagen.

Opmerkingen

Deze methode retourneert TRUE als er geen documenten zijn die moeten worden opgeslagen. Het retourneert ook TRUE zonder documenten op te slaan als het ophalen van of CWinAppCDocManager voor de toepassing een fout genereert.

Als u deze methode wilt gebruiken, moet AFX_RESTART_MANAGER_AUTOSAVE_AT_RESTART of AFX_RESTART_MANAGER_AUTOSAVE_AT_INTERVAL worden ingesteld in m_dwRestartManagerSupportFlags. Zie Voor meer informatie : Ondersteuning voor Restart Manager toevoegen.

CDataRecoveryHandler::AutosaveDocumentInfo

Hiermee wordt het opgegeven document automatisch opsave.

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

Parameterwaarden

pDocument
[in] Een aanwijzer naar de CDocument op te slaan.

bResetModifiedFlag
[in] TRUE geeft aan dat de CDataRecoveryHandlerpDocument moet worden gewijzigd; FALSE geeft aan dat het framework pDocument als ongewijzigd beschouwt. Zie de sectie Opmerkingen voor meer informatie over het effect van deze vlag.

Retourwaarde

WAAR als de juiste vlaggen zijn ingesteld en pDocument een geldig CDocument object is.

Opmerkingen

Elk CDocument object heeft een vlag die aangeeft of het is gewijzigd sinds de laatste opslag. Gebruik CDocument::IsModified om de status van deze vlag te bepalen. Als een CDocument bestand niet is gewijzigd sinds de laatste opslag, AutosaveDocumentInfo verwijdert u alle automatisch opgeslagen bestanden voor dat document. Als een document is gewijzigd sinds de laatste opslag, wordt de gebruiker gevraagd het document op te slaan voordat het wordt gesloten.

Opmerking

Als u bResetModifiedFlag gebruikt om de status van het document te wijzigen in ongewijzigde gegevens, kan dit ertoe leiden dat de gebruiker niet-opgeslagen gegevens kwijtraakt. Als het framework een document ongewijzigd beschouwt, wordt de gebruiker niet gevraagd het document op te slaan.

Met deze methode wordt een uitzondering gegenereerd met de macro ASSERT als pDocument geen geldig CDocument object is.

Als u deze methode wilt gebruiken, moet AFX_RESTART_MANAGER_AUTOSAVE_AT_RESTART of AFX_RESTARTMANAGER_AUTOSAVE_AT_INTERVAL worden ingesteld in m_dwRestartManagerSupportFlags.

CDataRecoveryHandler::CDataRecoveryHandler

Maakt een CDataRecoveryHandler object.

CDataRecoveryHandler(
    DWORD dwRestartManagerSupportFlags,
    int nAutosaveInterval);

Parameterwaarden

dwRestartManagerSupportFlags
[in] Geeft aan welke opties van de manager voor opnieuw opstarten worden ondersteund.

nAutosaveInterval
[in] De tijd tussen automatisch opslaan. Deze parameter bevindt zich in milliseconden.

Opmerkingen

Het MFC-framework maakt automatisch een CDataRecoveryHandler object voor uw toepassing wanneer u de wizard Nieuw project gebruikt. Tenzij u het herstelgedrag van gegevens of het beheer van opnieuw opstarten wilt aanpassen, moet u geen object maken CDataRecoveryHandler .

CDataRecoveryHandler::CreateDocumentInfo

Hiermee voegt u een document toe aan de lijst met geopende documenten.

virtual BOOL CreateDocumentInfo(CDocument* pDocument);

Parameterwaarden

pDocument
[in] Een aanwijzer naar een CDocument. Met deze methode worden de documentgegevens voor deze CDocumentmethode gemaakt.

Retourwaarde

De standaard implementatie retourneert TRUE.

Opmerkingen

Met deze methode wordt gecontroleerd of pDocument al in de lijst met documenten staat voordat het document wordt toegevoegd. Als pDocument al in de lijst staat, wordt met deze methode het automatisch opgeslagen bestand verwijderd dat is gekoppeld aan pDocument.

Als u deze methode wilt gebruiken, moet AFX_RESTART_MANAGER_AUTOSAVE_AT_RESTART of AFX_RESTARTMANAGER_AUTOSAVE_AT_INTERVAL worden ingesteld in m_dwRestartManagerSupportFlags.

CDataRecoveryHandler::D eleteAllAutosavedFiles

Hiermee verwijdert u alle huidige automatisch opgeslagen bestanden.

virtual BOOL DeleteAllAutosavedFiles();

Retourwaarde

De standaard implementatie retourneert altijd TRUE.

CDataRecoveryHandler::D eleteAutosavedFile

Hiermee verwijdert u het opgegeven automatisch opgeslagen bestand.

virtual BOOL DeleteAutosavedFile(const CString& strAutosavedFile);

Parameterwaarden

strAutosavedFile
[in] Een tekenreeks die de automatisch opgeslagen bestandsnaam bevat.

Retourwaarde

De standaard implementatie retourneert altijd TRUE.

Opmerkingen

Als met deze methode het automatisch opgeslagen bestand niet kan worden verwijderd, wordt de naam van het bestand in een lijst opgeslagen. Destructor voor de CDataRecoveryHandler pogingen om elk automatisch opgeslagen bestand te verwijderen dat in die lijst is opgegeven.

CDataRecoveryHandler::GenerateAutosaveFileName

Hiermee wordt de naam gegenereerd voor een automatisch opslaan-bestand dat is gekoppeld aan de opgegeven documentbestandsnaam.

virtual CString GenerateAutosaveFileName(const CString& strDocumentName) const;

Parameterwaarden

strDocumentName
[in] Een tekenreeks die de documentnaam bevat. GenerateAutosaveFileName gebruikt deze documentnaam om een overeenkomende bestandsnaam voor automatisch opslaan te genereren.

Retourwaarde

De automatisch opgeslagen bestandsnaam die is gegenereerd op basis van strDocumentName.

Opmerkingen

Elke documentnaam heeft een een-op-een-toewijzing met een bestandsnaam voor automatisch opslaan.

CDataRecoveryHandler::GetAutosaveInterval

Retourneert het interval tussen pogingen voor automatisch opslaan.

virtual int GetAutosaveInterval() const;

Retourwaarde

Het aantal milliseconden tussen automatisch opslaan probeert.

CDataRecoveryHandler::GetAutosavePath

Retourneert het pad van de automatisch opgeslagen bestanden.

virtual CString GetAutosavePath() const;

Retourwaarde

De locatie waar de automatisch opgeslagen documenten worden opgeslagen.

CDataRecoveryHandler::GetDocumentListName

Haalt de documentnaam op uit een CDocument object.

virtual CString GetDocumentListName(CDocument* pDocument) const;

Parameterwaarden

pDocument
[in] Een aanwijzer naar een CDocument. GetDocumentListName haalt de naam van het document op uit deze CDocument.

Retourwaarde

De documentnaam van pDocument.

Opmerkingen

De CDataRecoveryHandler naam van het document wordt gebruikt als sleutel in m_mapDocNameToAutosaveName, m_mapDocNameToDocumentPtr en m_mapDocNameToRestoreBool. Met deze parameter kunnen CDataRecoveryHandler objecten, de bestandsnaam voor automatisch opslaan en de instellingen voor automatisch opslaan worden bewaakt CDocument .

CDataRecoveryHandler::GetNormalDocumentTitle

Haalt de normale titel voor het opgegeven document op.

virtual CString GetNormalDocumentTitle(CDocument* pDocument);

Parameterwaarden

pDocument
[in] Een aanwijzer naar een CDocument.

Retourwaarde

De normale titel voor het opgegeven document.

Opmerkingen

De normale titel van een document is meestal de bestandsnaam van het document zonder het pad. Dit is de titel in het veld Bestandsnaam van het dialoogvenster Opslaan als .

CDataRecoveryHandler::GetRecoveredDocumentTitle

Hiermee maakt en retourneert u de titel voor het herstelde document.

virtual CString GetRecoveredDocumentTitle(const CString& strDocumentTitle) const;

Parameterwaarden

strDocumentTitle
[in] De normale titel voor het document.

Retourwaarde

De herstelde documenttitel.

Opmerkingen

Standaard is de herstelde titel van een document de normale titel waaraan [hersteld] is toegevoegd. De herstelde titel wordt aan de gebruiker weergegeven wanneer de CDataRecoveryHandler gebruiker wordt gevraagd om automatisch opgeslagen documenten te herstellen.

CDataRecoveryHandler::GetRestartIdentifier

Haalt de unieke herstart-id voor de toepassing op.

virtual CString GetRestartIdentifier() const;

Retourwaarde

De unieke herstart-id.

Opmerkingen

De id voor opnieuw opstarten is uniek voor elke uitvoering van de toepassing.

De CDataRecoveryHandler gegevens worden opgeslagen in het register over de momenteel geopende documenten. Wanneer de manager voor opnieuw opstarten een toepassing afsluit en opnieuw start, wordt de id voor opnieuw opstarten aan de CDataRecoveryHandlertoepassing geleverd. De CDataRecoveryHandler id voor opnieuw opstarten wordt gebruikt om de lijst met eerder geopende documenten op te halen. Hierdoor kunnen CDataRecoveryHandler automatisch opgeslagen bestanden worden gevonden en hersteld.

CDataRecoveryHandler::GetSaveDocumentInfoOnIdle

Hiermee wordt aangegeven of automatisch CDataRecoveryHandler opslaan op de huidige niet-actieve lus wordt uitgevoerd.

virtual BOOL GetSaveDocumentInfoOnIdle() const;

Retourwaarde

TRUE geeft de CDataRecoveryHandler automatisch opslaan op de huidige niet-actieve lus aan; FALSE geeft aan dat dit niet het geval is.

CDataRecoveryHandler::GetShutdownByRestartManager

Hiermee wordt aangegeven of de manager voor opnieuw opstarten ervoor heeft gezorgd dat de toepassing werd afgesloten.

virtual BOOL GetShutdownByRestartManager() const;

Retourwaarde

TRUE geeft aan dat de manager voor opnieuw opstarten de toepassing heeft afgesloten; FALSE geeft aan dat dit niet is gelukt.

CDataRecoveryHandler::Initialize

Initialiseert de CDataRecoveryHandler.

virtual BOOL Initialize();

Retourwaarde

WAAR als de initialisatie is geslaagd; anders ONWAAR.

Opmerkingen

Tijdens het initialisatieproces wordt het pad voor het opslaan van bestanden voor automatisch opslaan uit het register geladen. Als de Initialize methode deze map niet kan vinden of als het pad NULL is, Initialize mislukt en retourneert FALSE.

Gebruik CDataRecoveryHandler::SetAutosavePath om het pad voor automatisch opslaan te wijzigen nadat uw toepassing het CDataRecoveryHandler.

De Initialize methode start ook een timer om te controleren wanneer het volgende automatisch opslaan plaatsvindt. Gebruik CDataRecoveryHandler::SetAutosaveInterval om het interval voor automatisch opslaan te wijzigen nadat de toepassing de CDataRecoveryHandlerinitialisatie heeft geïnitialiseerd.

CDataRecoveryHandler::QueryRestoreAutosavedDocuments

Geeft een dialoogvenster weer aan de gebruiker voor elk document dat automatisch CDataRecoveryHandler is opgeslagen. Het dialoogvenster bepaalt of de gebruiker het automatisch opgeslagen document wil herstellen.

virtual void QueryRestoreAutosavedDocuments();

Opmerkingen

Als uw toepassing Unicode is, wordt met deze methode een CTaskDialog aan de gebruiker weergegeven. Anders gebruikt het framework AfxMessageBox om een query uit te voeren op de gebruiker.

Nadat QueryRestoreAutosavedDocuments alle antwoorden van de gebruiker zijn verzameld, worden de gegevens opgeslagen in de lidvariabele m_mapDocNameToRestoreBool. Met deze methode worden de automatisch opgeslagen documenten niet hersteld.

CDataRecoveryHandler::ReadOpenDocumentList

Laadt de lijst met geopende documenten uit het register.

virtual BOOL ReadOpenDocumentList();

Retourwaarde

TRUE geeft aan dat ReadOpenDocumentList de informatie voor ten minste één document uit het register is geladen; FALSE geeft aan dat er geen documentgegevens zijn geladen.

Opmerkingen

Met deze functie worden de geopende documentgegevens uit het register geladen en opgeslagen in de lidvariabele m_mapDocNameToAutosaveName.

Nadat ReadOpenDocumentList alle gegevens zijn geladen, worden de documentgegevens uit het register verwijderd.

CDataRecoveryHandler::RemoveDocumentInfo

Hiermee verwijdert u het opgegeven document uit de lijst met geopende documenten.

virtual BOOL RemoveDocumentInfo(CDocument* pDocument);

Parameterwaarden

pDocument
[in] Een aanwijzer naar het document dat u wilt verwijderen.

Retourwaarde

WAAR als pDocument uit de lijst is verwijderd; ONWAAR als er een fout is opgetreden.

Opmerkingen

Wanneer de gebruiker een document sluit, gebruikt het framework deze methode om het te verwijderen uit de lijst met geopende documenten.

Als RemoveDocumentInfopDocument niet kan worden gevonden in de lijst met geopende documenten, wordt er niets geretourneerd en wordt TRUE geretourneerd.

Als u deze methode wilt gebruiken, moet AFX_RESTART_MANAGER_REOPEN_PREVIOUS_FILES worden ingesteld in m_dwRestartManagerSupportFlags.

CDataRecoveryHandler::ReopenPreviousDocuments

Hiermee opent u de eerder geopende documenten.

virtual BOOL ReopenPreviousDocuments();

Retourwaarde

WAAR als ten minste één document is geopend; anders ONWAAR.

Opmerkingen

Met deze methode wordt de meest recente opslag van de eerder geopende documenten geopend. Als een document niet is opgeslagen of automatisch is opgeslagen, ReopenPreviousDocuments opent u een leeg document op basis van de sjabloon voor dat bestandstype.

Als u deze methode wilt gebruiken, moet AFX_RESTART_MANAGER_REOPEN_PREVIOUS_FILES worden ingesteld in m_dwRestartManagerSupportFlags. Als deze parameter niet is ingesteld, ReopenPreviousDocuments doet u niets en retourneert u FALSE.

Als er geen documenten zijn opgeslagen in de lijst met eerder geopende documenten, ReopenPreviousDocuments doet u niets en retourneert u ONWAAR.

CDataRecoveryHandler::RestoreAutosavedDocuments

Hiermee worden de automatisch opgeslagen documenten hersteld op basis van gebruikersinvoer.

virtual BOOL RestoreAutosavedDocuments();

Retourwaarde

WAAR als met deze methode de documenten zijn hersteld.

Opmerkingen

Met deze methode wordt CDataRecoveryHandler::QueryRestoreAutosavedDocuments aangeroepen om te bepalen welke documenten de gebruiker wil herstellen. Als een gebruiker besluit een automatisch opgeslagen document niet te herstellen, RestoreAutosavedDocuments verwijdert u het bestand voor automatisch opslaan. RestoreAutosavedDocuments Anders vervangt u het geopende document door de automatisch opgeslagen versie.

Als u deze methode wilt gebruiken, moet AFX_RESTART_MANAGER_REOPEN_PREVIOUS_FILES of AFX_RESTART_MANAGER_RESTORE_AUTOSAVED_FILES worden ingesteld in m_dwRestartManagerSupportFlags.

CDataRecoveryHandler::SaveOpenDocumentList

Hiermee wordt de huidige lijst met geopende documenten opgeslagen in het Windows-register.

virtual BOOL SaveOpenDocumentList();

Retourwaarde

WAAR als er geen geopende documenten zijn om op te slaan of als ze zijn opgeslagen. ONWAAR als er documenten zijn die in het register moeten worden opgeslagen, maar niet zijn opgeslagen omdat er een fout is opgetreden.

Opmerkingen

De manager voor opnieuw opstarten roept aan SaveOpenDocumentList wanneer de toepassing onverwacht wordt afgesloten of wanneer deze wordt afgesloten voor een upgrade. Wanneer de toepassing opnieuw wordt gestart, wordt CDataRecoveryHandler::ReadOpenDocumentList gebruikt om de lijst met geopende documenten op te halen.

Met deze methode wordt alleen de lijst met geopende documenten opgeslagen. De methode CDataRecoveryHandler::AutosaveDocumentInfo is verantwoordelijk voor het opslaan van de documenten zelf.

CDataRecoveryHandler::SetAutosaveInterval

Hiermee stelt u de tijd tussen automatisch opslaan cycli in milliseconden in.

Virtual void SetAutosaveInterval(int nAutosaveInterval);

Parameterwaarden

nAutosaveInterval
[in] Het nieuwe interval voor automatisch opslaan in milliseconden.

CDataRecoveryHandler::SetAutosavePath

Hiermee stelt u de map in waarin automatisch opgeslagen bestanden worden opgeslagen.

virtual void SetAutosavePath(const CString& strAutosavePath);

Parameterwaarden

strAutosavePath
[in] Het pad waarin bestanden voor automatisch opslaan worden opgeslagen.

Opmerkingen

Als u de map voor automatisch opslaan wijzigt, worden momenteel niet automatisch opgeslagen bestanden verplaatst.

CDataRecoveryHandler::SetRestartIdentifier

Hiermee stelt u de unieke id voor opnieuw opstarten in voor dit exemplaar van de CDataRecoveryHandler.

virtual void SetRestartIdentifier(const CString& strRestartIdentifier);

Parameterwaarden

strRestartIdentifier
[in] De unieke id voor de manager voor opnieuw opstarten.

Opmerkingen

De manager voor opnieuw opstarten registreert informatie over de geopende documenten in het register. Deze informatie wordt opgeslagen met de unieke herstart-id als de sleutel. Omdat de id voor opnieuw opstarten uniek is voor elk exemplaar van een toepassing, kunnen meerdere exemplaren van een toepassing onverwacht worden afgesloten en kan de manager voor opnieuw opstarten elk van deze exemplaren herstellen.

CDataRecoveryHandler::SetSaveDocumentInfoOnIdle

Hiermee stelt u in of de CDataRecoveryHandler geopende documentgegevens tijdens de huidige niet-actieve cyclus in het Windows-register worden opgeslagen.

virtual void SetSaveDocumentInfoOnIdle(BOOL bSaveOnIdle);

Parameterwaarden

bSaveOnIdle
[in] TRUE om documentgegevens op te slaan tijdens de huidige niet-actieve cyclus; FALSE om geen opslag uit te voeren.

CDataRecoveryHandler::SetShutdownByRestartManager

Hiermee stelt u in of de vorige exit van de toepassing is veroorzaakt door de manager voor opnieuw opstarten.

virtual void SetShutdownByRestartManager(BOOL bShutdownByRestartManager);

Parameterwaarden

bShutdownByRestartManager
[in] WAAR om aan te geven dat de manager voor opnieuw opstarten ervoor zorgde dat de toepassing werd afgesloten; FALSE om aan te geven dat de toepassing om een andere reden is afgesloten.

Opmerkingen

Het framework gedraagt zich anders op basis van of de vorige exit onverwacht was of of het is gestart door de manager voor opnieuw opstarten.

CDataRecoveryHandler::UpdateDocumentInfo

Hiermee wordt de informatie voor een document bijgewerkt omdat de gebruiker het document heeft opgeslagen.

virtual BOOL UpdateDocumentInfo(CDocument* pDocument);

Parameterwaarden

pDocument
[in] Een aanwijzer naar het opgeslagen document.

Retourwaarde

WAAR als met deze methode het automatisch opgeslagen document is verwijderd en de documentgegevens zijn bijgewerkt; ONWAAR als er een fout is opgetreden.

Opmerkingen

Wanneer een gebruiker een document opslaat, verwijdert de toepassing het automatisch opgeslagen bestand omdat het niet meer nodig is. UpdateDocumentInfo verwijdert het automatisch opgeslagen bestand door CDataRecoveryHandler::RemoveDocumentInfo aan te roepen. UpdateDocumentInfo voegt vervolgens de gegevens van pDocument toe aan de lijst met geopende documenten, omdat RemoveDocumentInfo deze informatie wordt verwijderd, maar het opgeslagen document nog steeds is geopend.

Als u deze methode wilt gebruiken, moet AFX_RESTART_MANAGER_REOPEN_PREVIOUS_FILES worden ingesteld in m_dwRestartManagerSupportFlags.

Zie ook

Klassen
Hiërarchiegrafiek
CObject-klasse
Procedure: Ondersteuning voor Restart Manager toevoegen

  • Last updated on