CWinApp::RegisterWithRestartManager

Artículo
04/10/2013

Registra la aplicación con el administrador de reinicio.

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

Parámetros

Parámetro	Descripción
[in] bRegisterRecoveryCallback	TRUE indica que esta instancia de la aplicación utiliza una función de devolución de llamada de recuperación; FALSE indica que no almacena.El marco de trabajo llama a la función de devolución de llamada de recuperación cuando se cierra la aplicación inesperado.Para obtener más información, vea CWinApp::ApplicationRecoveryCallback.
[in] strRestartIdentifier	La cadena única que identifica esta instancia del administrador de reinicio.El identificador del administrador de reinicio es único para cada instancia de una aplicación.
[in] pwzCommandLineArgs	Una cadena que contiene cualquier argumento adicional de la línea de comandos.
[in] dwRestartFlags	Marcas opcionales para el administrador de reinicio.Para obtener más información, vea la sección Comentarios.
[in] pRecoveryCallback	La función de devolución de llamada de recuperación.Esta función debe tomar un parámetro de LPVOID como entrada y devolver DWORD.La función de devolución de llamada predeterminada de recuperación es CWinApp::ApplicationRecoveryCallback.
[in] lpvParam	El parámetro de entrada para la función de devolución de llamada de recuperación.Para obtener más información, vea CWinApp::ApplicationRecoveryCallback.
[in] dwPingInterval	El intervalo de tiempo que el administrador de reinicio espera la función de devolución de llamada de recuperación para devolver.Este parámetro es en milisegundos.
[in] dwCallbackFlags	Indicadores pasados a la función de devolución de llamada de recuperación.Reservado para uso futuro.

Valor devuelto

S_OK si el método es correcto; si no es un código de error.

Comentarios

Si la aplicación utiliza la implementación predeterminada de MFC para autoguardar archivos, debe utilizar la versión sencilla de RegisterWithRestartManager.Utilice la versión compleja de RegisterWithRestartManager si desea personalizar el comportamiento de autoguardado de la aplicación.

Si se llama a este método con una cadena vacía para strRestartIdentifier, RegisterWithRestartManager crea una cadena del identificador único para esta instancia del administrador de reinicio.

Cuando se cierra una aplicación inesperada, el administrador de reinicio reinicia la aplicación desde la línea de comandos y proporciona el identificador único de reinicio como argumento opcional.En este escenario, el marco de trabajo llama a RegisterWithRestartManager dos veces.La primera llamada procede de CWinApp::InitInstance con una cadena vacía para el identificador de cadena.A continuación, el método CWinApp::ProcessShellCommand llama RegisterWithRestartManager con el identificador único del reinicio.

Al registrar una aplicación con el administrador de reinicio, el administrador de reinicio controla la aplicación.Si existe la aplicación inesperada, el administrador de reinicio llama a la función de devolución de llamada de recuperación durante el proceso cerrado.El administrador de reinicio espera dwPingInterval una respuesta de la función de devolución de llamada de recuperación.Si la función de devolución de llamada de recuperación no responde dentro de este tiempo, la aplicación sale sin ejecutar la función de devolución de llamada de recuperación.

De forma predeterminada, los dwRestartFlags no se admiten pero se proporcionan para uso futuro.Los valores posibles para dwRestartFlags son los siguientes: