CWinApp::RegisterWithRestartManager

Článek
03/04/2013

Registruje aplikaci správce restartovat.

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
);

Parametry

Parametr	Description
[v]bRegisterRecoveryCallback	TRUEoznačuje, že tato instance aplikace používá funkci zpětného volání pro obnovení; FALSEoznačuje, že není.Rámci volání funkce obnovení zpětné volání, pokud je aplikace neočekávaně ukončena.Další informace naleznete v tématu CWinApp::ApplicationRecoveryCallback.
[v]strRestartIdentifier	Jedinečný řetězec, který identifikuje tuto instanci restartování správce.Identifikátor správce restartování je jedinečný pro každou instanci aplikace.
[v]pwzCommandLineArgs	Řetězec, který obsahuje všechny další argumenty z příkazového řádku.
[v]dwRestartFlags	Volitelné příznaky pro restartování správce.Další informace naleznete v části Poznámky.
[v]pRecoveryCallback	Funkce zpětného volání pro obnovení.Tato funkce musí trvat LPVOID parametr jako vstup a návrat DWORD .Obnovení výchozí funkce zpětného volání je CWinApp::ApplicationRecoveryCallback .
[v]lpvParam	Vstupní parametr pro funkci zpětného volání pro obnovení.Další informace naleznete v tématu CWinApp::ApplicationRecoveryCallback.
[v]dwPingInterval	Délka doby restartování správce čeká na návrat funkce zpětného volání pro obnovení.Tento parametr je v milisekundách.
[v]dwCallbackFlags	Příznaky předaný funkci zpětného volání pro obnovení.Vyhrazeno pro budoucí použití.

Vrácená hodnota

S_OKJestliže je metoda úspěšná. v opačném případě kód chyby.

Poznámky

Pokud aplikace používá výchozí implementace MFC pro automatické ukládání souborů, používejte jednoduché verzi RegisterWithRestartManager .Komplexní verze RegisterWithRestartManager Pokud chcete přizpůsobit chování automatické ukládání v aplikaci.

Pokud volání této metody s prázdný řetězec strRestartIdentifier , RegisterWithRestartManager jedinečný identifikátor řetězec pro tuto instanci restartování vytvoří správce.

Pokud je aplikace neočekávaně ukončena, správce restartovat restartuje aplikaci z příkazového řádku a poskytuje že jedinečný identifikátor jako nepovinný argument restartovat.V tomto scénáři rámci volá RegisterWithRestartManager dvakrát.První volání pochází z CWinApp::InitInstance s identifikátorem řetězec prázdný řetězec.V metodě CWinApp::ProcessShellCommand volání RegisterWithRestartManager s restartování jedinečný identifikátor.

Po registraci aplikace Správce restartovat restartování správce sleduje aplikace.Pokud je aplikace neočekávaně ukončena, restartování správce volání funkce zpětného volání pro zotavení během procesu vypnutí.Čeká restartování správce dwPingInterval pro odpověď funkce zpětného volání pro obnovení.Pokud zpětné volání funkce zotavení v této lhůtě neodpoví, ukončí aplikace bez spuštění funkce zpětného volání pro obnovení.

Standardně dwRestartFlags nejsou podporovány, ale jsou k dispozici pro budoucí použití.Možné hodnoty pro dwRestartFlags jsou následující: