다음을 통해 공유


CWinApp::RegisterWithRestartManager

응용 프로그램이 다시 시작 관리자에 등록합니다.

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

매개 변수

Parameter

설명

[in] bRegisterRecoveryCallback

TRUE이 인스턴스를 응용 프로그램의 복구 하는 콜백 함수를 사용 하 여 나타냅니다. FALSE그렇지 않은 것을 나타냅니다.프레임 워크 응용 프로그램을 예기치 않게 종료 될 때 복구 콜백 함수를 호출 합니다.자세한 내용은 CWinApp::ApplicationRecoveryCallback를 참조하십시오.

[in] strRestartIdentifier

이 인스턴스를 다시 시작 관리자를 식별 하는 고유 문자열입니다.다시 시작 관리자 식별자는 응용 프로그램의 각 인스턴스에 대해 고유한입니다.

[in] pwzCommandLineArgs

추가 명령줄에서 인수를 포함 하는 문자열입니다.

[in] dwRestartFlags

다시 시작 관리자에 대 한 선택적 플래그입니다.자세한 내용은 설명 단원을 참조하십시오.

[in] pRecoveryCallback

복구 콜백 함수입니다.이 함수를 수행 해야를 LPVOID 입력 및 반환 매개 변수는 DWORD.기본 복구 콜백 함수인 CWinApp::ApplicationRecoveryCallback.

[in] lpvParam

복구 콜백 함수에 대 한 입력된 매개 변수입니다.자세한 내용은 CWinApp::ApplicationRecoveryCallback를 참조하십시오.

[in] dwPingInterval

다시 시작 관리자 복구 콜백 함수에 반환 될 때까지 기다리는 시간의 길이입니다.이 매개 변수 (밀리초)입니다.

[in] dwCallbackFlags

플래그 복구 콜백 함수에 전달 합니다.다음에 사용하도록 예약됩니다.

반환 값

S_OK메서드가 성공 하면. 그렇지 않으면 오류 코드입니다.

설명

응용 프로그램 기본 MFC 구현 자동 저장 파일을 사용 하는 경우의 간단한 버전을 사용 해야 RegisterWithRestartManager.복잡 한 버전을 사용 하 여 RegisterWithRestartManager 응용 프로그램의 자동 저장 동작을 사용자 지정 하려는 경우.

이 메서드는 빈 문자열을 호출할 경우 strRestartIdentifier, RegisterWithRestartManager 관리자 다시 인스턴스의 고유 식별자 문자열을 만듭니다.

응용 프로그램이 예기치 않게 종료 되 면 다시 시작 관리자는 명령줄에서 응용 프로그램을 다시 시작 하 고 고유 식별자로 선택적 인수를 다시 시작을 제공 합니다.이 시나리오에서는 프레임 워크에서 호출 RegisterWithRestartManager 두 번.첫 번째 호출에서 가져온 CWinApp::InitInstance 는 빈 문자열에 대 한 문자열 식별자입니다.그런 다음 메서드 CWinApp::ProcessShellCommand 호출 RegisterWithRestartManager 다시 시작을 고유 식별자.

다시 시작 관리자와 응용 프로그램을 등록 한 후 다시 시작 관리자 응용 프로그램을 모니터링 합니다.응용 프로그램이 예기치 않게 종료 되 면 다시 시작 관리자는 종료 프로세스 동안 복구 콜백 함수를 호출 합니다.다시 시작 관리자 대기는 dwPingInterval 복구 콜백 함수에서 응답 합니다.이 시간 내 복구 콜백 함수를 응답 하지 않을 경우 응용 프로그램 복구 콜백 함수를 실행 하지 않고 종료 됩니다.

기본적으로 dwRestartFlags 지원 되지 않는 있지만 나중에 사용할 수 있도록 제공 됩니다.가능한 값에 대 한 dwRestartFlags 은 다음과 같습니다.

  • RESTART_NO_CRASH

  • RESTART_NO_HANG

  • RESTART_NO_PATCH

  • RESTART_NO_REBOOT

요구 사항

헤더: afxwin.h

참고 항목

참조

CWinApp 클래스

계층 구조 차트

CWinApp::SupportsRestartManager

CWinApp::ApplicationRecoveryCallback

CDataRecoveryHandler 클래스