IComponent2::RestoreResultView 메서드(mmc.h)

아티클
08/24/2023

RestoreResultView 메서드는 결과 뷰를 복원합니다. 이 메서드를 사용하면 스냅인에서 결과 보기의 특정 스냅인 세부 정보를 복원할 수 있습니다. 자세한 내용은 결과 뷰 복원을 참조하세요.

이 메서드는 MMCN_RESTORE_VIEW 알림의 사용을 대체합니다.

구문

HRESULT RestoreResultView(
  [in] MMC_COOKIE             cookie,
  [in] PRESULT_VIEW_TYPE_INFO pResultViewType
);

매개 변수

[in] cookie

결과 뷰가 복원될 고유 식별자를 지정하는 값입니다.

[in] pResultViewType

결과 뷰의 RESULT_VIEW_TYPE_INFO 구조체에 대한 포인터입니다.

반환 값

성공하면 반환 값이 S_OK. 스냅인은 *pResultViewType의 정보에 따라 MMC가 보기를 복원하지 못하도록 S_FALSE 반환할 수 있습니다. 다른 반환 값은 오류 코드를 나타냅니다.

설명

*pResultViewType의 pstrPersistableViewDescription 멤버는 결과 보기에 할당된 이름을 지정합니다. pstrPersistableViewDescription 멤버로 식별된 결과 보기를 복원하기 위해 스냅인은 *pResultViewType의 나머지 멤버를 채웁니다. 결과 보기의 이름은 원래 스냅인의 IComponent2::GetResultViewType2 구현 중에 할당됩니다. MMC는 IComponent2::RestoreResultView 를 호출하여 사용자가 결과 보기를 다시 방문할 때 스냅인이 내부 보기 설정을 복원할 수 있도록 합니다.

사용자가 보기를 사용자 지정할 때 일부 설정(예: 보기 옵션 또는 보기 모드)은 MMC에서 알려져 있으며 일부 설정(예: 이벤트 뷰어 스냅인의 가장 오래된 첫 번째)은 스냅인 내부입니다. MMC 2.0 이전에는 MMC가 스냅인과 통신하여 내부 보기 설정을 복원하는 메커니즘이 없었습니다. 그러나 MMC 2.0의 IComponent2::GetResultViewType2 및 IComponent2::RestoreResultView 메서드는 내부 보기 설정이 복원되는 메커니즘을 제공합니다. 스냅인은 RESULT_VIEW_TYPE_INFO 구조체의 pstrPersistableViewDescription 멤버에 대해 내부 보기 설정을 유지합니다. MMC 가 IComponent2::RestoreResultView 를 호출하여 결과 보기를 복원하는 경우 스냅인은 지속형 설정을 사용하여 보기 복원을 완료합니다.

사용자는 MMC 뒤로/앞으로 단추를 누르거나 저장된 콘솔 파일을 로드하여 결과 보기를 다시 확인합니다.