CWinApp::RegisterWithRestartManager

Articolo
02/19/2013

Registra l'applicazione con Gestione riavvio.

virtual HRESULT RegisterWithRestartManager(
   BOOL bRegisterRecoveryCallback,
   const CString &strRestartIdentifier
);

virtual HRESULT RegisterWithRestartManager(
   LPCWSTR pwzCommandLineArgs,
   DWORD dwRestartFlags,
   APPLICATION_RECOVERY_CALLBACK pRecoveryCallback,
   LPVOID lpvParam,
   DWORD dwPingInterval,
   DWORD dwCallbackFlags
);

Parametri

Parametro	Descrizione
[in] bRegisterRecoveryCallback	TRUE indica che questa istanza dell'applicazione utilizza una funzione di callback di recupero, FALSE indica che non è possibile.Il framework chiama la funzione di callback di recupero alla chiusura dell'applicazione in modo imprevisto.Per ulteriori informazioni, vedere CWinApp::ApplicationRecoveryCallback.
[in] strRestartIdentifier	La stringa univoca che identifica questa istanza di Gestione riavvio.l'identificatore di Gestione riavvio è univoco per ogni istanza di un'applicazione.
[in] pwzCommandLineArgs	Stringa contenente tutti gli argomenti aggiuntivi dalla riga di comando.
[in] dwRestartFlags	Flag facoltativi per Gestione riavvio.Per ulteriori informazioni, vedere la sezione "Note".
[in] pRecoveryCallback	La funzione di callback di recupero.Questa funzione deve accettare un parametro LPVOID come input e restituire DWORD.La funzione di callback di recupero predefinita è CWinApp::ApplicationRecoveryCallback.
[in] lpvParam	Il parametro di input per la funzione di callback di recupero.Per ulteriori informazioni, vedere CWinApp::ApplicationRecoveryCallback.
[in] dwPingInterval	La durata di Gestione riavvio della funzione di callback di recupero da restituire.Questo parametro è espressa in millisecondi.
[in] dwCallbackFlags	Flag passati alla funzione di callback di recupero.Riservato per utilizzi futuri.

Valore restituito

S_OK se il metodo ha esito positivo; in caso contrario un codice di errore.

Note

Se l'applicazione utilizza l'implementazione di impostazione predefinita MFC per i file autosaving, è necessario utilizzare la versione semplice RegisterWithRestartManager.Utilizzare la versione complessa RegisterWithRestartManager se si desidera personalizzare il comportamento di autosave dell'applicazione.

Se si chiama il metodo con una stringa vuota per strRestartIdentifier, RegisterWithRestartManager crea una stringa dell'identificatore univoco per questa istanza di Gestione riavvio.

Quando un'applicazione chiuso in modo imprevisto, Gestione riavvio riavvia l'applicazione dalla riga di comando e fornisce identificatore univoco di riavvio come argomento facoltativo.In questo scenario, il framework chiama RegisterWithRestartManager due volte.La prima chiamata viene da CWinApp::InitInstance con una stringa vuota per l'identificatore di stringa.Quindi, il metodo chiama CWinApp::ProcessShellCommandRegisterWithRestartManager con l'identificatore univoco del riavvio.

Dopo aver registrato un'applicazione con Gestione riavvio, Gestione riavvio consente di monitorare applicazione.Se la chiusura dell'applicazione in modo imprevisto, Gestione riavvio chiama la funzione di callback di recupero durante il processo di.Gestione riavvio è dwPingInterval una risposta dalla funzione di callback di recupero.Se la funzione di callback di recupero non risponde entro i limiti del tempo, la chiusura dell'applicazione senza eseguire la funzione di callback di recupero.

Per impostazione predefinita, i dwRestartFlags non sono supportati ma sono forniti per un utilizzo futuro.I valori possibili per dwRestartFlags sono: