IComponent2::GetResultViewType2 메서드(mmc.h)
GetResultViewType2 메서드는 결과 뷰 형식을 검색합니다. 이 메서드는 IComponent::GetResultViewType 메서드를 대체합니다.
구문
HRESULT GetResultViewType2(
[in] MMC_COOKIE cookie,
[in, out] PRESULT_VIEW_TYPE_INFO pResultViewType
);
매개 변수
[in] cookie
scope 항목에 대한 snapin 제공 고유 식별자를 지정하는 값입니다. MMC의 쿠키에 대한 자세한 내용은 쿠키를 참조하세요.
[in, out] pResultViewType
결과 뷰의 RESULT_VIEW_TYPE_INFO 구조체에 대한 포인터입니다. 스냅인에서 IComponent2를 구현하는 경우 RESULT_VIEW_TYPE_INFO 구조체의 pstrPersistableViewDescription 멤버에 유효한 뷰 설명 문자열이 포함되어야 합니다. 그렇지 않으면 MMC가 스냅인을 초기화하지 않습니다. pstrPersistableViewDescription 멤버는 CoTaskMemAlloc에 의해 할당되어야 합니다. 스냅인은 MMC에서 해제되므로 pstrPersistableViewDescription을 해제해서는 안 됩니다.
반환 값
성공하면 반환 값이 S_OK. 다른 반환 값은 오류 코드를 나타냅니다.
설명
결과 뷰를 만드는 동안 MMC는 스냅인의 IComponent2::GetResultViewType2 메서드를 호출합니다. 사용자가 *pResultViewType의 pstrPersistableViewDescription 멤버에 의해 명명된 결과 뷰를 다시 방문하면 MMC는 스냅인의 IComponent2::RestoreResultView 메서드를 호출합니다. 이때 스냅인은 복원된 결과 보기에 대한 스냅인별 세부 정보(있는 경우)를 제공할 수 있습니다. 사용자는 MMC 뒤로/앞으로 단추 또는 저장된 콘솔 파일 로드를 통해 결과 보기를 다시 확인합니다. IComponent2::GetResultViewType2 및 IComponent2::RestoreResultView 메서드 사용에 대한 자세한 내용은 결과 뷰 복원을 참조하세요.
스냅인이 OCX(ActiveX 컨트롤) 뷰를 구현하는 경우 스냅인은 OCX를 만들고 MMC에 RESULT_VIEW_TYPE_INFO 구조체(특히 구조체의 pUnkControl 멤버)에 OCX IUnknown 포인터를 제공합니다. 스냅인은 OCX 생성을 제어하므로 스냅인은 필요에 따라 라이선스 또는 보안 문제를 해결할 수 있습니다. GetResultViewType2를 호출하는 동안 스냅인은 OCX를 초기화할 수도 있습니다(스냅인은 MMCN_INITOCX 알림을 받지 않음).
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows Vista |
| 지원되는 최소 서버 | Windows Server 2008 |
| 대상 플랫폼 | Windows |
| 헤더 | mmc.h |