Метод IComponent2::GetResultViewType2 (mmc.h)
Метод GetResultViewType2 извлекает тип представления результата. Этот метод заменяет метод IComponent::GetResultViewType .
Синтаксис
HRESULT GetResultViewType2(
[in] MMC_COOKIE cookie,
[in, out] PRESULT_VIEW_TYPE_INFO pResultViewType
);
Параметры
[in] cookie
Значение типа , указывающее предоставленный оснасткой уникальный идентификатор для элемента область. Дополнительные сведения о файлах cookie в MMC см. в разделе Файлы cookie.
[in, out] pResultViewType
Указатель на структуру RESULT_VIEW_TYPE_INFO для представления результатов. Если оснастка реализует IComponent2, элемент pstrPersistableViewDescription структуры RESULT_VIEW_TYPE_INFO должен содержать допустимую строку описания представления; В противном случае MMC не инициализирует оснастку. Элемент pstrPersistableViewDescription должен быть выделен coTaskMemAlloc. Оснастка не должна освобождать pstrPersistableViewDescription, так как она будет освобождена MMC.
Возвращаемое значение
В случае успешного выполнения возвращаемое значение будет S_OK. Другие возвращаемые значения указывают на код ошибки.
Комментарии
Во время создания представления результатов MMC вызывает метод IComponent2::GetResultViewType2 оснастки. Когда пользователь вернется к представлению результатов с именем члена pstrPersistableViewDescription *pResultViewType, MMC вызовет метод IComponent2::RestoreResultView оснастки, после чего оснастка может предоставить сведения о оснастке (если таковые есть) для восстановленного представления результатов. Пользователь возвращает представление результатов с помощью кнопок MMC Back/Forward или загрузки сохраненного файла консоли. Дополнительные сведения об использовании методов IComponent2::GetResultViewType2 и IComponent2::RestoreResultView см. в разделе Восстановление представлений результатов.
Если оснастка реализует представление OCX (элемент ActiveX), то оснастка создает OCX и предоставляет MMC с указателем OCX IUnknown в структуре RESULT_VIEW_TYPE_INFO (в частности, элемент pUnkControl структуры). Оснастка управляет созданием OCX, поэтому оснастка может при необходимости устранять проблемы с лицензированием или безопасностью. Во время вызова GetResultViewType2 оснастка также может инициализировать OCX (оснастка не будет получать уведомление MMCN_INITOCX ).
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows Vista |
| Минимальная версия сервера | Windows Server 2008 |
| Целевая платформа | Windows |
| Header | mmc.h |