Condividi tramite


Classe CDataRecoveryHandler

I CDataRecoveryHandler documenti vengono salvati automaticamente e ripristinati se un'applicazione viene chiusa in modo imprevisto.

Sintassi

class CDataRecoveryHandler : public CObject

Membri

Costruttori

Nome Descrizione
CDataRecoveryHandler::CDataRecoveryHandler Costruisce un oggetto CDataRecoveryHandler.

Metodi

Nome Descrizione
CDataRecoveryHandler::AutosaveAllDocumentInfo Consente di archiviare automaticamente ogni file registrato con la CDataRecoveryHandler classe .
CDataRecoveryHandler::AutosaveDocumentInfo Elimina automaticamente il documento specificato.
CDataRecoveryHandler::CreateDocumentInfo Aggiunge un documento all'elenco di documenti aperti.
CDataRecoveryHandler::D eleteAllAutosavedFiles Elimina tutti i file salvati automaticamente correnti.
CDataRecoveryHandler::D eleteAutosavedFile Elimina il file salvato automaticamente specificato.
CDataRecoveryHandler::GenerateAutosaveFileName Genera il nome di un file di salvataggio automatico associato al nome del file di documento specificato.
CDataRecoveryHandler::GetAutosaveInterval Restituisce l'intervallo tra tentativi di salvataggio automatico.
CDataRecoveryHandler::GetAutosavePath Restituisce il percorso dei file salvati automaticamente.
CDataRecoveryHandler::GetDocumentListName Recupera il nome del documento da un CDocument oggetto .
CDataRecoveryHandler::GetNormalDocumentTitle Recupera il titolo normale per il documento specificato.
CDataRecoveryHandler::GetRecoveredDocumentTitle Crea e restituisce il titolo per il documento recuperato.
CDataRecoveryHandler::GetRestartIdentifier Recupera l'identificatore di riavvio univoco per l'applicazione.
CDataRecoveryHandler::GetSaveDocumentInfoOnIdle Indica se CDataRecoveryHandler esegue un salvataggio automatico nel ciclo di inattività corrente.
CDataRecoveryHandler::GetShutdownByRestartManager Indica se il gestore di riavvio ha causato la chiusura dell'applicazione.
CDataRecoveryHandler::Initialize Inizializza CDataRecoveryHandler.
CDataRecoveryHandler::QueryRestoreAutosavedDocuments Visualizza una finestra di dialogo all'utente per ogni documento CDataRecoveryHandler salvato automaticamente. La finestra di dialogo determina se l'utente desidera ripristinare il documento salvato automaticamente.
CDataRecoveryHandler::ReadOpenDocumentList Carica l'elenco di documenti aperti dal Registro di sistema.
CDataRecoveryHandler::RemoveDocumentInfo Rimuove il documento fornito dall'elenco di documenti aperti.
CDataRecoveryHandler::ReopenPreviousDocuments Apre i documenti aperti in precedenza.
CDataRecoveryHandler::RestoreAutosavedDocuments Ripristina i documenti salvati automaticamente in base all'input dell'utente.
CDataRecoveryHandler::SaveOpenDocumentList Salva l'elenco corrente di documenti aperti nel Registro di sistema di Windows.
CDataRecoveryHandler::SetAutosaveInterval Imposta il tempo tra cicli di salvataggio automatico in millisecondi.
CDataRecoveryHandler::SetAutosavePath Imposta la directory in cui vengono archiviati i file salvati automaticamente.
CDataRecoveryHandler::SetRestartIdentifier Imposta l'identificatore di riavvio univoco per questa istanza di CDataRecoveryHandler.
CDataRecoveryHandler::SetSaveDocumentInfoOnIdle Imposta un valore che indica se CDataRecoveryHandler salva le informazioni del documento aperto nel Registro di sistema di Windows durante il ciclo di inattività corrente.
CDataRecoveryHandler::SetShutdownByRestartManager Imposta un valore che indica se l'uscita precedente dell'applicazione è stata causata dal gestore di riavvio.
CDataRecoveryHandler::UpdateDocumentInfo Aggiorna le informazioni per un documento perché l'utente l'ha salvata.

Membri dei dati

Nome Descrizione
m_bRestoringPreviousOpenDocs Indica se il gestore di recupero dati riapre i documenti aperti in precedenza.
m_bSaveDocumentInfoOnIdle Indica se il gestore di recupero dati esegue automaticamente l'intercettazione automatica dei documenti nel ciclo di inattività successivo.
m_bShutdownByRestartManager Indica se il gestore di riavvio causa l'uscita dell'applicazione.
m_dwRestartManagerSupportFlags Flag che indicano il supporto fornito dal gestore di riavvio per l'applicazione.
m_lstAutosavesToDelete Elenco di file salvati automaticamente che non sono stati eliminati quando i documenti originali sono stati chiusi. Quando l'applicazione viene chiusa, il gestore di riavvio ritenta l'eliminazione dei file.
m_mapDocNameToAutosaveName Mappa dei nomi dei documenti ai nomi di file salvati automaticamente.
m_mapDocNameToDocumentPtr Mappa dei nomi dei documenti ai puntatori CDocument .
m_mapDocNameToRestoreBool Mappa dei nomi dei documenti a un parametro booleano che indica se ripristinare il documento salvato automaticamente.
m_mapDocumentPtrToDocName Mappa dei CDocument puntatori ai nomi dei documenti.
m_mapDocumentPtrToDocTitle Mappa dei CDocument puntatori ai titoli dei documenti. Questi titoli vengono usati per salvare i file.
m_nAutosaveInterval Tempo in millisecondi tra le operazioni di intercettazione automatica.Time in milliseconds between autosaves.
m_nTimerID Identificatore del timer di salvataggio automatico.
m_strAutosavePath Percorso in cui vengono archiviati i documenti salvati automaticamente.
m_strRestartIdentifier Rappresentazione di stringa di un GUID per il gestore di riavvio.

Osservazioni:

Il gestore di riavvio usa la CDataRecoveryHandler classe per tenere traccia di tutti i documenti aperti e di salvarli automaticamente in base alle esigenze. Per abilitare il salvataggio automatico, usare il metodo CDataRecoveryHandler::SetSaveDocumentInfoOnIdle . Questo metodo indica all'oggetto CDataRecoveryHandler di eseguire un salvataggio automatico nel ciclo inattivo successivo. Il gestore di riavvio chiama SetSaveDocumentInfoOnIdle quando CDataRecoveryHandler deve eseguire un salvataggio automatico.

Tutti i metodi della CDataRecoveryHandler classe sono virtuali. Eseguire l'override dei metodi in questa classe per creare un gestore di recupero dati personalizzato. A meno che non si crei un gestore di recupero dati o un gestore di riavvio, non creare un'istanza di CDataRecoveryHandler. La classe CWinApp crea un CDataRecoveryHandler oggetto in base alle esigenze.

Prima di poter usare un CDataRecoveryHandler oggetto, è necessario chiamare CDataRecoveryHandler::Initialize.

Poiché la CDataRecoveryHandler classe è strettamente connessa al gestore di riavvio, CDataRecoveryHandler dipende dal parametro m_dwRestartManagerSupportFlagsglobale . Questo parametro determina quali autorizzazioni ha il gestore di riavvio e come interagisce con l'applicazione. Per incorporare il gestore di riavvio in un'applicazione esistente, è necessario assegnare m_dwRestartManagerSupportFlags il valore appropriato nel costruttore dell'applicazione principale. Per altre informazioni su come usare il gestore di riavvio, vedere Procedura: Aggiungere il supporto di Gestione riavvio.

Requisiti

Intestazione: afxdatarecovery.h

CDataRecoveryHandler::AutosaveAllDocumentInfo

Consente di archiviare automaticamente ogni file registrato con la CDataRecoveryHandler classe .

virtual BOOL AutosaveAllDocumentInfo();

Valore restituito

TRUE se tutti CDataRecoveryHandler i documenti sono stati salvati; FALSE se un documento non è stato salvato.

Osservazioni:

Questo metodo restituisce TRUE se non sono presenti documenti che devono essere salvati. Restituisce anche TRUE senza salvare documenti se il recupero di CWinApp o CDocManager per l'applicazione genera un errore.

Per usare questo metodo, è necessario impostare AFX_RESTART_MANAGER_AUTOSAVE_AT_RESTART o AFX_RESTART_MANAGER_AUTOSAVE_AT_INTERVAL in m_dwRestartManagerSupportFlags. Per altre informazioni, vedere Procedura: Aggiungere il supporto di Restart Manager.

CDataRecoveryHandler::AutosaveDocumentInfo

Elimina automaticamente il documento specificato.

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

Parametri

pDocument
[in] Puntatore all'oggetto CDocument da salvare.

bResetModifiedFlag
[in] TRUE indica che considera CDataRecoveryHandler pDocument da modificare; FALSE indica che il framework considera pDocument non modificato. Per altre informazioni sull'effetto di questo flag, vedere la sezione Osservazioni.

Valore restituito

TRUE se i flag appropriati sono impostati e pDocument è un oggetto valido CDocument .

Osservazioni:

Ogni CDocument oggetto ha un flag che indica se è stato modificato dall'ultimo salvataggio. Usare CDocument::IsModified per determinare lo stato di questo flag. Se un oggetto CDocument non è stato modificato dopo l'ultimo salvataggio, AutosaveDocumentInfo elimina tutti i file salvati automaticamente per tale documento. Se un documento è stato modificato dopo l'ultimo salvataggio, la chiusura richiede all'utente di salvare il documento prima della chiusura.

Nota

L'uso di bResetModifiedFlag per modificare lo stato del documento in modo non modificato può causare la perdita di dati non salvati da parte dell'utente. Se il framework considera un documento non modificato, la chiusura non richiede all'utente di salvare.

Questo metodo genera un'eccezione con la macro ASSERT se pDocument non è un oggetto valido CDocument .

Per utilizzare questo metodo, è necessario impostare AFX_RESTART_MANAGER_AUTOSAVE_AT_RESTART o AFX_RESTARTMANAGER_AUTOSAVE_AT_INTERVAL in m_dwRestartManagerSupportFlags.

CDataRecoveryHandler::CDataRecoveryHandler

Costruisce un oggetto CDataRecoveryHandler.

CDataRecoveryHandler(
    DWORD dwRestartManagerSupportFlags,
    int nAutosaveInterval);

Parametri

dwRestartManagerSupportFlags
[in] Indica le opzioni supportate dal gestore di riavvio.

nAutosaveInterval
[in] Tempo tra le autosaves. Questo parametro è espresso in millisecondi.

Osservazioni:

Il framework MFC crea automaticamente un CDataRecoveryHandler oggetto per l'applicazione quando si usa la procedura guidata Nuovo progetto . A meno che non si stia personalizzando il comportamento di ripristino dei dati o il gestore di riavvio, non è consigliabile creare un CDataRecoveryHandler oggetto .

CDataRecoveryHandler::CreateDocumentInfo

Aggiunge un documento all'elenco di documenti aperti.

virtual BOOL CreateDocumentInfo(CDocument* pDocument);

Parametri

pDocument
[in] Puntatore a un oggetto CDocument. Questo metodo crea le informazioni sul documento per questo CDocumentoggetto .

Valore restituito

L'implementazione predefinita restituisce TRUE.

Osservazioni:

Questo metodo controlla se pDocument è già presente nell'elenco dei documenti prima di aggiungere il documento. Se pDocument è già presente nell'elenco, questo metodo elimina il file salvato automaticamente associato a pDocument.

Per utilizzare questo metodo, è necessario impostare AFX_RESTART_MANAGER_AUTOSAVE_AT_RESTART o AFX_RESTARTMANAGER_AUTOSAVE_AT_INTERVAL in m_dwRestartManagerSupportFlags.

CDataRecoveryHandler::D eleteAllAutosavedFiles

Elimina tutti i file salvati automaticamente correnti.

virtual BOOL DeleteAllAutosavedFiles();

Valore restituito

L'implementazione predefinita restituisce sempre TRUE.

CDataRecoveryHandler::D eleteAutosavedFile

Elimina il file salvato automaticamente specificato.

virtual BOOL DeleteAutosavedFile(const CString& strAutosavedFile);

Parametri

strAutosavedFile
[in] Stringa contenente il nome file salvato automaticamente.

Valore restituito

L'implementazione predefinita restituisce sempre TRUE.

Osservazioni:

Se questo metodo non può eliminare il file salvato automaticamente, salva il nome del file in un elenco. Distruttore per l'oggetto CDataRecoveryHandler tenta di eliminare ogni file salvato automaticamente specificato nell'elenco.

CDataRecoveryHandler::GenerateAutosaveFileName

Genera il nome di un file di salvataggio automatico associato al nome del file di documento specificato.

virtual CString GenerateAutosaveFileName(const CString& strDocumentName) const;

Parametri

strDocumentName
[in] Stringa contenente il nome del documento. GenerateAutosaveFileName utilizza questo nome di documento per generare un nome file di salvataggio automatico corrispondente.

Valore restituito

Nome file di salvataggio automatico generato da strDocumentName.

Osservazioni:

Ogni nome di documento ha un mapping uno-a-uno con un nome file di salvataggio automatico.

CDataRecoveryHandler::GetAutosaveInterval

Restituisce l'intervallo tra tentativi di salvataggio automatico.

virtual int GetAutosaveInterval() const;

Valore restituito

Numero di millisecondi tra tentativi di salvataggio automatico.

CDataRecoveryHandler::GetAutosavePath

Restituisce il percorso dei file salvati automaticamente.

virtual CString GetAutosavePath() const;

Valore restituito

Percorso in cui vengono archiviati i documenti salvati automaticamente.

CDataRecoveryHandler::GetDocumentListName

Recupera il nome del documento da un CDocument oggetto .

virtual CString GetDocumentListName(CDocument* pDocument) const;

Parametri

pDocument
[in] Puntatore a un oggetto CDocument. GetDocumentListName recupera il nome del documento da questo CDocumentoggetto .

Valore restituito

Nome del documento da pDocument.

Osservazioni:

CDataRecoveryHandler usa il nome del documento come chiave in m_mapDocNameToAutosaveName, m_mapDocNameToDocumentPtr e m_mapDocNameToRestoreBool. Questi parametri consentono di monitorare CDocument gli CDataRecoveryHandler oggetti, il nome del file di salvataggio automatico e le impostazioni di salvataggio automatico.

CDataRecoveryHandler::GetNormalDocumentTitle

Recupera il titolo normale per il documento specificato.

virtual CString GetNormalDocumentTitle(CDocument* pDocument);

Parametri

pDocument
[in] Puntatore a un oggetto CDocument.

Valore restituito

Titolo normale per il documento specificato.

Osservazioni:

Il titolo normale di un documento è in genere il nome file del documento senza il percorso. Si tratta del titolo nel campo Nome file della finestra di dialogo Salva con nome.

CDataRecoveryHandler::GetRecoveredDocumentTitle

Crea e restituisce il titolo per il documento recuperato.

virtual CString GetRecoveredDocumentTitle(const CString& strDocumentTitle) const;

Parametri

strDocumentTitle
[in] Titolo normale per il documento.

Valore restituito

Titolo del documento recuperato.

Osservazioni:

Per impostazione predefinita, il titolo recuperato di un documento è il titolo normale con [ripristinato] aggiunto. Il titolo recuperato viene visualizzato all'utente quando esegue una CDataRecoveryHandler query sull'utente per ripristinare i documenti salvati automaticamente.

CDataRecoveryHandler::GetRestartIdentifier

Recupera l'identificatore di riavvio univoco per l'applicazione.

virtual CString GetRestartIdentifier() const;

Valore restituito

Identificatore di riavvio univoco.

Osservazioni:

L'identificatore di riavvio è univoco per ogni esecuzione dell'applicazione.

Archivia CDataRecoveryHandler le informazioni nel Registro di sistema sui documenti attualmente aperti. Quando il gestore di riavvio esce da un'applicazione e lo riavvia, fornisce l'identificatore di CDataRecoveryHandlerriavvio a . CDataRecoveryHandler Usa l'identificatore di riavvio per recuperare l'elenco dei documenti aperti in precedenza. In questo modo è possibile CDataRecoveryHandler provare a trovare e ripristinare i file salvati automaticamente.

CDataRecoveryHandler::GetSaveDocumentInfoOnIdle

Indica se CDataRecoveryHandler esegue un salvataggio automatico nel ciclo di inattività corrente.

virtual BOOL GetSaveDocumentInfoOnIdle() const;

Valore restituito

TRUE indica i CDataRecoveryHandler processi automatici nel ciclo di inattività corrente; FALSE indica che non lo fa.

CDataRecoveryHandler::GetShutdownByRestartManager

Indica se il gestore di riavvio ha causato la chiusura dell'applicazione.

virtual BOOL GetShutdownByRestartManager() const;

Valore restituito

TRUE indica che il gestore di riavvio ha causato la chiusura dell'applicazione; FALSE indica che non è stato eseguito.

CDataRecoveryHandler::Initialize

Inizializza CDataRecoveryHandler.

virtual BOOL Initialize();

Valore restituito

TRUE se l'inizializzazione ha esito positivo; in caso contrario FALSE.

Osservazioni:

Il processo di inizializzazione carica il percorso per archiviare i file di salvataggio automatico dal Registro di sistema. Se il metodo non riesce a Initialize trovare questa directory o se il percorso è NULL, Initialize ha esito negativo e restituisce FALSE.

Usare CDataRecoveryHandler::SetAutosavePath per modificare il percorso di salvataggio automatico dopo che l'applicazione inizializza .CDataRecoveryHandler

Il Initialize metodo avvia anche un timer da monitorare quando si verifica il successivo salvataggio automatico. Usare CDataRecoveryHandler::SetAutosaveInterval per modificare l'intervallo di salvataggio automatico dopo che l'applicazione inizializza .CDataRecoveryHandler

CDataRecoveryHandler::QueryRestoreAutosavedDocuments

Visualizza una finestra di dialogo all'utente per ogni documento CDataRecoveryHandler salvato automaticamente. La finestra di dialogo determina se l'utente desidera ripristinare il documento salvato automaticamente.

virtual void QueryRestoreAutosavedDocuments();

Osservazioni:

Se l'applicazione è Unicode, questo metodo visualizza un CTaskDialog all'utente. In caso contrario, il framework usa AfxMessageBox per eseguire query sull'utente.

Dopo QueryRestoreAutosavedDocuments aver raccolto tutte le risposte dall'utente, archivia le informazioni nella variabile membro m_mapDocNameToRestoreBool. Questo metodo non ripristina i documenti salvati automaticamente.

CDataRecoveryHandler::ReadOpenDocumentList

Carica l'elenco di documenti aperti dal Registro di sistema.

virtual BOOL ReadOpenDocumentList();

Valore restituito

TRUE indica che ReadOpenDocumentList le informazioni caricate per almeno un documento dal Registro di sistema; FALSE indica che non sono state caricate informazioni sul documento.

Osservazioni:

Questa funzione carica le informazioni del documento aperto dal Registro di sistema e le archivia nella variabile membro m_mapDocNameToAutosaveName.

Dopo ReadOpenDocumentList aver caricato tutti i dati, elimina le informazioni del documento dal Registro di sistema.

CDataRecoveryHandler::RemoveDocumentInfo

Rimuove il documento fornito dall'elenco di documenti aperti.

virtual BOOL RemoveDocumentInfo(CDocument* pDocument);

Parametri

pDocument
[in] Puntatore al documento da rimuovere.

Valore restituito

TRUE se pDocument è stato rimosso dall'elenco; FALSE se si è verificato un errore.

Osservazioni:

Quando l'utente chiude un documento, il framework usa questo metodo per rimuoverlo dall'elenco di documenti aperti.

Se RemoveDocumentInfo non è possibile trovare pDocument nell'elenco dei documenti aperti, non esegue alcuna operazione e restituisce TRUE.

Per utilizzare questo metodo, AFX_RESTART_MANAGER_REOPEN_PREVIOUS_FILES deve essere impostato in m_dwRestartManagerSupportFlags.

CDataRecoveryHandler::ReopenPreviousDocuments

Apre i documenti aperti in precedenza.

virtual BOOL ReopenPreviousDocuments();

Valore restituito

TRUE se è stato aperto almeno un documento; in caso contrario FALSE.

Osservazioni:

Questo metodo apre il salvataggio più recente dei documenti aperti in precedenza. Se un documento non è stato salvato o salvato automaticamente, ReopenPreviousDocuments apre un documento vuoto basato sul modello per tale tipo di file.

Per utilizzare questo metodo, AFX_RESTART_MANAGER_REOPEN_PREVIOUS_FILES deve essere impostato in m_dwRestartManagerSupportFlags. Se questo parametro non è impostato, ReopenPreviousDocuments non esegue alcuna operazione e restituisce FALSE.

Se non sono presenti documenti archiviati nell'elenco di documenti aperti in precedenza, ReopenPreviousDocuments non esegue alcuna operazione e restituisce FALSE.

CDataRecoveryHandler::RestoreAutosavedDocuments

Ripristina i documenti salvati automaticamente in base all'input dell'utente.

virtual BOOL RestoreAutosavedDocuments();

Valore restituito

TRUE se il metodo ripristina correttamente i documenti.

Osservazioni:

Questo metodo chiama CDataRecoveryHandler::QueryRestoreAutosavedDocuments per determinare quali documenti l'utente vuole ripristinare. Se un utente decide di non ripristinare un documento salvato automaticamente, RestoreAutosavedDocuments elimina il file di salvataggio automatico. In caso contrario, RestoreAutosavedDocuments sostituisce il documento aperto con la versione salvata automaticamente.

Per usare questo metodo, è necessario impostare AFX_RESTART_MANAGER_REOPEN_PREVIOUS_FILES o AFX_RESTART_MANAGER_RESTORE_AUTOSAVED_FILES in m_dwRestartManagerSupportFlags.

CDataRecoveryHandler::SaveOpenDocumentList

Salva l'elenco corrente di documenti aperti nel Registro di sistema di Windows.

virtual BOOL SaveOpenDocumentList();

Valore restituito

TRUE se non sono presenti documenti aperti da salvare o se sono stati salvati correttamente. FALSE se sono presenti documenti da salvare nel Registro di sistema, ma non sono stati salvati perché si è verificato un errore.

Osservazioni:

Il gestore di riavvio chiama SaveOpenDocumentList quando l'applicazione viene chiusa in modo imprevisto o quando termina per un aggiornamento. Quando l'applicazione viene riavviata, usa CDataRecoveryHandler::ReadOpenDocumentList per recuperare l'elenco di documenti aperti.

Questo metodo salva solo l'elenco di documenti aperti. Il metodo CDataRecoveryHandler::AutosaveDocumentInfo è responsabile del salvataggio dei documenti stessi.

CDataRecoveryHandler::SetAutosaveInterval

Imposta il tempo tra cicli di salvataggio automatico in millisecondi.

Virtual void SetAutosaveInterval(int nAutosaveInterval);

Parametri

nAutosaveInterval
[in] Nuovo intervallo di salvataggio automatico in millisecondi.

CDataRecoveryHandler::SetAutosavePath

Imposta la directory in cui vengono archiviati i file salvati automaticamente.

virtual void SetAutosavePath(const CString& strAutosavePath);

Parametri

strAutosavePath
[in] Percorso in cui vengono archiviati i file di salvataggio automatico.

Osservazioni:

La modifica della directory di salvataggio automatico non sposta i file attualmente salvati automaticamente.

CDataRecoveryHandler::SetRestartIdentifier

Imposta l'identificatore di riavvio univoco per questa istanza di CDataRecoveryHandler.

virtual void SetRestartIdentifier(const CString& strRestartIdentifier);

Parametri

strRestartIdentifier
[in] Identificatore univoco per il gestore di riavvio.

Osservazioni:

Il gestore di riavvio registra informazioni sui documenti aperti nel Registro di sistema. Queste informazioni vengono archiviate con l'identificatore di riavvio univoco come chiave. Poiché l'identificatore di riavvio è univoco per ogni istanza di un'applicazione, più istanze di un'applicazione possono uscire in modo imprevisto e il gestore di riavvio può recuperarli ognuno di essi.

CDataRecoveryHandler::SetSaveDocumentInfoOnIdle

Imposta un valore che indica se CDataRecoveryHandler salva le informazioni del documento aperto nel Registro di sistema di Windows durante il ciclo di inattività corrente.

virtual void SetSaveDocumentInfoOnIdle(BOOL bSaveOnIdle);

Parametri

bSaveOnIdle
[in] TRUE per salvare le informazioni del documento durante il ciclo di inattività corrente; FALSE per non eseguire un salvataggio.

CDataRecoveryHandler::SetShutdownByRestartManager

Imposta un valore che indica se l'uscita precedente dell'applicazione è stata causata dal gestore di riavvio.

virtual void SetShutdownByRestartManager(BOOL bShutdownByRestartManager);

Parametri

bShutdownByRestartManager
[in] TRUE per indicare che il gestore di riavvio ha causato la chiusura dell'applicazione; FALSE per indicare che l'applicazione è stata chiusa per un altro motivo.

Osservazioni:

Il framework si comporta in modo diverso in base al fatto che l'uscita precedente sia stata imprevista o se è stata avviata dal gestore di riavvio.

CDataRecoveryHandler::UpdateDocumentInfo

Aggiorna le informazioni per un documento perché l'utente l'ha salvata.

virtual BOOL UpdateDocumentInfo(CDocument* pDocument);

Parametri

pDocument
[in] Puntatore al documento salvato.

Valore restituito

TRUE se questo metodo ha eliminato il documento salvato automaticamente e aggiornato le informazioni del documento; FALSE se si è verificato un errore.

Osservazioni:

Quando un utente salva un documento, l'applicazione rimuove il file salvato automaticamente perché non è più necessario. UpdateDocumentInfo elimina il file salvato automaticamente chiamando CDataRecoveryHandler::RemoveDocumentInfo. UpdateDocumentInfo aggiunge quindi le informazioni da pDocument all'elenco dei documenti attualmente aperti perché RemoveDocumentInfo elimina tali informazioni, ma il documento salvato è ancora aperto.

Per utilizzare questo metodo, AFX_RESTART_MANAGER_REOPEN_PREVIOUS_FILES deve essere impostato in m_dwRestartManagerSupportFlags.

Vedi anche

Classi
Grafico della gerarchia
Classe CObject
Procedura: Aggiungere il supporto di Gestione riavvio