CWinApp::RegisterWithRestartManager
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í:
RESTART_NO_CRASH
RESTART_NO_HANG
RESTART_NO_PATCH
RESTART_NO_REBOOT
Požadavky
Záhlaví: afxwin.h
Viz také
Referenční dokumentace
CWinApp::SupportsRestartManager