Метод IComponent::GetResultViewType (mmc.h)
Метод IComponent::GetResultViewType определяет, каким должно быть представление области результатов.
Синтаксис
HRESULT GetResultViewType(
[in] MMC_COOKIE cookie,
[out] LPOLESTR *ppViewType,
[out] long *pViewOptions
);
Параметры
[in] cookie
Значение типа , указывающее предоставленный оснасткой уникальный идентификатор элемента область. Дополнительные сведения о файлах cookie в MMC см. в разделе Файлы cookie.
[out] ppViewType
Указатель на адрес строки, указывающей представление, отображаемое для указанного файла cookie. Вызываемый (оснастка) выделяет строку типа представления с помощью функции COM API CoTaskMemAlloc , а вызывающий объект (MMC) освобождает ее с помощью CoTaskMemFree.
Возвращаемая строка зависит от типа представления:
Стандартный список
Для стандартных представлений списков MMC не использует это значение. Если оснастка использует только стандартные представления списка, оснастка может задать для параметра ppViewTypeзначение NULL. MMC использует стандартные представления списка в качестве типа представления по умолчанию.
Панель задач
Для представления панели задач, использующего шаблоны панели задач MMC, ppViewType должен указывать на адрес строки, содержащей путь к ресурсу для шаблона панели задач, и имя группы, идентифицирующее панель задач. Имейте в виду, что MMC передает имя группы в вызовах методов IExtendTaskPad , чтобы включить оснастку для идентификации конкретной отображаемой панели задач (это важно, если оснастка имеет несколько панели задач).
Строка должна иметь следующий вид:
"имягруппышаблона# res:// filepath/"
Где filepath — это полный путь к исполняемому файлу MMC (MMC.exe), template — это имя файла шаблона, хранящегося в качестве ресурса в файле, заданном путем к файлу, а groupname — это имя, определяющее панель задач.
MMC предоставляет следующие HTML-файлы в виде шаблонов:
| Файл ресурсов | Описание |
|---|---|
| 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, за исключением того, что путь к файлу должен указывать путь к библиотеке DLL оснастки, которая хранит настраиваемую HTML-страницу в качестве ресурса.
Пользовательский OCX
Для пользовательского представления, предоставляемого пользовательским элементом управления OLE (OCX), ppViewType должен указывать на адрес строки, содержащей строковое представление CLSID пользовательского элемента управления. Строка должна начинаться с открытой фигурной скобки ({) и заканчиваться закрывающей фигурной скобкой (}). Следующая строка представляет элемент управления Calendar и может быть возвращена в параметре ppViewType для отображения элемента управления Calendar в области результатов: "{8E27C92B-1264-101C-8A2F-040224009C02}".
MMC позволяет использовать один экземпляр каждого типа OCX на экземпляр оснастки на представление. Если параметр MMC_VIEW_OPTIONS_CREATENEW не выбран, MMC отобразит кэшированный экземпляр OCX для любого из область элементов оснастки, запрашивающих это представление OCX. Если выбран параметр MMC_VIEW_OPTIONS_CREATENEW , MMC уничтожит кэшированный OCX и создаст новый каждый раз, когда элемент запрашивает представление OCX.
Пользовательская веб-страница
Для пользовательского представления, предоставляемого веб-страницей, ppViewType должен указывать на адрес строки, содержащей URL-адрес страницы. Следующая строка представляет URL-адрес веб-сайта Майкрософт и может быть возвращена в параметре ppViewType для отображения веб-сайта в области результатов: "www.microsoft.com".
[out] pViewOptions
Указатель на значение, которое предоставляет консоли параметры, заданные оснасткой-владельцем. Это значение может быть комбинацией следующих:
MMC_VIEW_OPTIONS_CREATENEW (0x0010)
Для пользовательского представления OCX. В MMC 1.2 OCX всегда кэшируется. Если этот флаг не указан, MMC 1.2 отображает кэшированный экземпляр OCX для любого из область элементов оснастки, запрашивающих это представление OCX. Если этот флаг указан, MMC 1.2 удаляет кэшированный OCX и создает (а затем кэширует) новый каждый раз, когда элемент запрашивает представление OCX. В MMC 2.0 OCX будет кэшироваться только в том случае, если этот флаг не установлен. В MMC 2.0 оснастка может освободить любые OCX, если узел не выбран, если этот флаг установлен.
После того как оснастка указала параметр кэширования OCX для узла (с помощью или без использования флага MMC_VIEW_OPTIONS_CREATENEW ), она не должна изменять выбор параметра для этого экземпляра оснастки.
MMC_VIEW_OPTIONS_EXCLUDE_SCOPE_ITEMS_FROM_LIST (0x00000040)
Новые возможности в MMC 1.2. В стандартном представлении списка этот параметр указывает MMC скрывать область элементы в представлении. Элементы области автоматически скрываются в представлениях виртуальных списков.
MMC_VIEW_OPTIONS_FILTERED (0x0008)
Уведомляет MMC о том, что оснастка поддерживает отфильтрованные представления. См. раздел Добавление отфильтрованных представлений.
MMC_VIEW_OPTIONS_LEXICAL_SORT (0x00000080)
Новые возможности в MMC 1.2. В стандартном представлении списка этот параметр указывает MMC сначала лексически сортировать все область элементы (включая расширения), а затем все результирующий элемент. Интерфейсы 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.
MMC вызывает GetResultViewType при выборе элемента оснастки область. При переключении со стандартного представления списка на пользовательское оснастка должна вызвать IConsole2::SelectScopeItem , чтобы повторно выбрать элемент и принудительно вызвать GetResultViewType . Это позволяет оснастке указать соответствующий пользовательский OCX или веб-страницу, чтобы mmc могла загрузить ее. При переключении с пользовательского представления на стандартное представление списка MMC автоматически вызывает GetResultViewType и задает соответствующий тип представления списка.
При использовании строки Юникода функция связывания шрифтов определяет оптимальный шрифт для отображения этой строки. Например, если вы заполняли представление списка именами серверов и знали, что половина будет на японском языке, а половина — на русском, то вы бы задали параметры представления связывания шрифтов, а MMC определит подходящий шрифт. По умолчанию не используется связывание шрифтов, так как при поиске подходящего шрифта MMC наблюдается небольшое снижение производительности.
Файл cookie — это указатель на структуру, содержащую сведения, уникальные для определенного элемента. Он передается через член lParam структуры SCOPEDATAITEM .
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows Vista |
| Минимальная версия сервера | Windows Server 2008 |
| Целевая платформа | Windows |
| Header | mmc.h |