IComponent::GetResultViewType 메서드(mmc.h)

IComponent::GetResultViewType 메서드는 결과 창 보기를 결정합니다.

구문

HRESULT GetResultViewType(
  [in]  MMC_COOKIE cookie,
  [out] LPOLESTR   *ppViewType,
  [out] long       *pViewOptions
);

매개 변수

[in] cookie

scope 항목에 대한 snapin 제공 고유 식별자를 지정하는 값입니다. MMC의 쿠키에 대한 자세한 내용은 쿠키를 참조하세요.

[out] ppViewType

지정된 쿠키에 대해 표시할 보기를 지정하는 문자열 주소에 대한 포인터입니다. 호출 수신자(스냅인)는 COM API 함수 CoTaskMemAlloc 을 사용하여 뷰 형식 문자열을 할당하고 호출자(MMC)는 CoTaskMemFree를 사용하여 해제합니다.

반환되는 문자열은 뷰 형식에 따라 달라집니다.

표준 목록

표준 목록 보기의 경우 MMC는 이 값을 사용하지 않습니다. 스냅인에서 표준 목록 보기만 사용하는 경우 스냅인은 ppViewType을NULL로 설정할 수 있습니다. MMC는 표준 목록 보기를 기본 보기 형식으로 사용합니다.

창

MMC 작업 패드 템플릿을 사용하는 작업 패드 보기의 경우 ppViewType 은 작업 패드 템플릿에 대한 리소스 경로와 작업 패드를 식별하는 그룹 이름을 포함하는 문자열의 주소를 가리킵니다. MMC는 IExtendTaskPad 메서드 호출에서 그룹 이름을 전달하여 스냅인이 표시되는 특정 작업 패드를 식별할 수 있도록 합니다(스냅인에 여러 작업 패드가 있는 경우 중요).

문자열에는 다음 형식이 있어야 합니다.

"res:// 파일 경로/템플릿#그룹 이름"

여기서 filepath 는 MMC 실행 파일(MMC.exe)의 전체 경로이며 , 템플릿 은 파일 경로로 지정된 파일 내에 리소스로 저장된 템플릿의 파일 이름이며 groupname 은 작업 패드를 식별하는 이름입니다.

MMC는 다음 HTML 파일을 템플릿으로 제공합니다.

리소스 파일	Description
default.htm	표준 작업 패드용 템플릿
listpad.htm	"세로" 목록 보기 작업 패드에 대한 템플릿
horizontal.htm	"가로" 목록 보기 작업 패드에 대한 템플릿

 

예를 들어 다음 문자열은 MMC.exe 경로가 c:\Windows\System32\mmc.exe, 표준 작업 패드가 표시되고(default.htm) 그룹 이름이 tpad1임을 지정합니다. "res://c:\Windows\System32\mmc.exe/default.htm#tpad1".

사용자 지정 HTML 페이지를 사용하는 작업 패드 보기의 경우 ppViewType 은 사용자 지정 작업 패드의 HTML 파일에 대한 리소스 경로와 작업 패드를 식별하는 그룹 이름을 포함하는 문자열의 주소를 가리킵니다. 문자열은 MMC 작업 패드 템플릿에 대한 문자열과 동일한 형식을 맺습니다. 파일 경로 는 사용자 지정 HTML 페이지를 리소스로 저장하는 스냅인의 DLL 경로를 지정해야 합니다.

사용자 지정 OCX

OLE OCX(사용자 지정 컨트롤)에서 제공하는 사용자 지정 보기의 경우 ppViewType 은 사용자 지정 컨트롤의 CLSID의 문자열 표현을 포함하는 문자열의 주소를 가리킵니다. 문자열은 열린 중괄호({)로 시작하고 중괄호(})로 끝나야 합니다. 다음 문자열은 Calendar 컨트롤을 나타내며 결과 창에 일정 컨트롤을 표시하기 위해 ppViewType 매개 변수에 반환될 수 있습니다. "{8E27C92B-1264-101C-8A2F-040224009C02}".

MMC는 보기당 스냅인 instance 각 OCX 유형의 단일 instance 허용합니다. MMC_VIEW_OPTIONS_CREATENEW 옵션을 선택하지 않으면 MMC는 이 OCX 보기를 요청하는 스냅인의 scope 항목에 대해 캐시된 OCX instance 표시합니다. MMC_VIEW_OPTIONS_CREATENEW 옵션을 선택하면 MMC는 캐시된 OCX를 삭제하고 항목이 OCX 보기를 요청할 때마다 새 OCX를 만듭니다.

사용자 지정 웹 페이지

웹 페이지에서 제공하는 사용자 지정 보기의 경우 ppViewType 은 페이지의 URL이 포함된 문자열의 주소를 가리킵니다. 다음 문자열은 Microsoft 웹 사이트의 URL을 나타내며 ppViewType 매개 변수에 반환되어 결과 창에 웹 사이트를 표시할 수 있습니다. "www.microsoft.com".

[out] pViewOptions

소유 스냅인에서 지정한 옵션을 콘솔에 제공하는 값에 대한 포인터입니다. 이 값은 다음의 조합일 수 있습니다.

MMC_VIEW_OPTIONS_CREATENEW(0x0010)

사용자 지정 OCX 보기의 경우 MMC 1.2에서는 OCX가 항상 캐시됩니다. 이 플래그를 지정하지 않으면 MMC 1.2는 이 OCX 보기를 요청하는 스냅인의 scope 항목에 대해 캐시된 OCX instance 표시합니다. 이 플래그를 지정하면 MMC 1.2는 캐시된 OCX를 삭제하고 항목이 OCX 보기를 요청할 때마다 새 OCX를 만듭니다(캐시). MMC 2.0에서는 이 플래그가 설정되지 않은 경우에만 OCX가 캐시됩니다. MMC 2.0에서 스냅인은 이 플래그가 설정된 경우 노드가 선택 취소될 때 모든 OCX를 해제할 수 있습니다.

스냅인에서 노드에 대한 OCX 캐싱 옵션을 지정한 경우(MMC_VIEW_OPTIONS_CREATENEW 플래그를 사용하거나 사용하지 않음) 스냅인의 이 instance 대한 옵션 선택을 변경해서는 안 됩니다.

MMC_VIEW_OPTIONS_EXCLUDE_SCOPE_ITEMS_FROM_LIST(0x00000040)

MMC 1.2의 새로운 기능 표준 목록 보기에서 이 옵션은 보기에서 scope 항목을 숨기도록 MMC에 지시합니다. 범위 항목은 가상 목록 보기에서 자동으로 숨겨집니다.

MMC_VIEW_OPTIONS_FILTERED(0x0008)

스냅인이 필터링된 보기를 지원한다는 것을 MMC에 알 수 있습니다. 필터링된 뷰 추가를 참조하세요.

MMC_VIEW_OPTIONS_LEXICAL_SORT(0x00000080)

MMC 1.2의 새로운 기능 표준 목록 보기에서 이 옵션은 MMC에게 모든 scope 항목(확장 포함)을 어휘적으로 정렬한 다음 모든 결과 항목을 정렬하도록 지시합니다. 이 옵션을 설정하면 IResultDataCompare 및 IResultDataCompareEx 인터페이스가 무시됩니다.

MMC_VIEW_OPTIONS_MULTISELECT(0x0004)

결과 창 보기에서 여러 항목을 선택할 수 있습니다.

MMC_VIEW_OPTIONS_NOLISTVIEWS(0x0001)

보기 메뉴에서 표준 목록 보기 선택을 표시하지 않도록 콘솔에 지시합니다. 스냅인에서 결과 창에 고유한 사용자 지정 보기만 표시할 수 있습니다.

MMC_VIEW_OPTIONS_NONE(0)

선택한 보기 옵션이 없습니다. 기본 보기 옵션입니다.

MMC_VIEW_OPTIONS_OWNERDATALIST(0x0002)

결과 창 목록 보기가 가상 목록이어야 임을 지정하는 값입니다.

MMC_VIEW_OPTIONS_USEFONTLINKING(0x0020)

결과 항목에서 글꼴 연결을 사용합니다(다국어 지원). 자세한 내용은 설명을 참조하세요.

ppViewType이 사용자 지정 보기 형식인 경우 보기가 사용자 지정 보기에서 표준 목록 보기로 전환될 때 표준 목록 보기에 영향을 주는 보기 옵션이 MMC에 의해 적용됩니다.

반환 값

이 메서드는 이러한 값 중 하나를 반환할 수 있습니다.

설명

호출 수신자(스냅인)는 COM API 함수 CoTaskMemAlloc 을 사용하여 뷰 형식 문자열을 할당하고 호출자(MMC)는 CoTaskMemFree를 사용하여 해제합니다.

스냅인 scope 항목이 선택되면 MMC는 GetResultViewType을 호출합니다. 표준 목록 보기에서 사용자 지정 보기로 전환할 때 스냅인은 IConsole2::SelectScopeItem 을 호출하여 항목을 다시 선택하고 MMC가 GetResultViewType 을 다시 호출하도록 강제해야 합니다. 이를 통해 스냅인은 MMC가 로드할 수 있도록 적절한 사용자 지정 OCX 또는 웹 페이지를 지정할 수 있습니다. 사용자 지정 보기에서 표준 목록 보기로 전환할 때 MMC는 GetResultViewType을 자동으로 호출하고 적절한 목록 보기 유형을 설정합니다.

유니코드 문자열이 지정된 경우 글꼴 연결 기능은 해당 문자열을 표시하는 가장 적합한 글꼴을 결정합니다. 예를 들어 목록 보기를 서버 이름으로 채우고 절반이 일본어이고 절반은 러시아어로 표시되도록 알고 있는 경우 글꼴 연결 보기 옵션을 설정하고 MMC가 적절한 글꼴을 결정합니다. MMC가 적절한 글꼴을 검색할 때 성능이 저하되므로 기본값은 글꼴 연결을 사용하지 않는 것입니다.

쿠키는 특정 항목에 고유한 정보를 포함하는 구조체에 대한 포인터입니다. SCOPEDATAITEM 구조체의 lParam 멤버를 통해 전달됩니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista
지원되는 최소 서버	Windows Server 2008
대상 플랫폼	Windows
헤더	mmc.h

추가 정보

IComponent

Idataobject