Метод IComponent2::RestoreResultView (mmc.h)
Метод 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. Оснастка может возвращать S_FALSE, чтобы не позволить MMC восстановить представление на основе сведений в *pResultViewType. Другие возвращаемые значения указывают на код ошибки.
Комментарии
Элемент pstrPersistableViewDescription элемента *pResultViewType указывает имя, присвоенное представлению результатов. Чтобы восстановить представление результатов, определенное элементом pstrPersistableViewDescription , оснастка заполняет остальные элементы *pResultViewType. Имя представления результатов изначально присваивается во время реализации оснастки IComponent2::GetResultViewType2. MMC вызывает IComponent2::RestoreResultView , чтобы оснастка может восстановить внутренние параметры представления при повторном просмотре результирующих представлений пользователем.
Когда пользователь настраивает представление, некоторые параметры (например, параметры представления или режим представления) известны MMC, а некоторые (например, Старые первые в оснастке Просмотр событий) являются внутренними для оснастки. До mmc 2.0 не было механизма взаимодействия MMC с оснасткой для восстановления параметров внутреннего представления. Однако методы IComponent2::GetResultViewType2 и IComponent2::RestoreResultView в MMC 2.0 предоставляют механизм восстановления параметров внутреннего представления. Оснастка сохраняет внутренние параметры представления для элемента pstrPersistableViewDescriptionструктуры RESULT_VIEW_TYPE_INFO . Когда MMC вызывает IComponent2::RestoreResultView для восстановления представления результатов, оснастка использует сохраненные параметры для завершения восстановления представления.
Пользователь возвращается к представлению результатов, нажимая кнопки MMC Back/Forward или загружая сохраненный файл консоли.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows Vista |
| Минимальная версия сервера | Windows Server 2008 |
| Целевая платформа | Windows |
| Header | mmc.h |