Метод IPropertySheetProvider::Show (mmc.h)
Если тип, заданный в IPropertySheetProvider::CreatePropertySheet , является листом свойств, IPropertySheetProvider::Show отображает фрейм листа свойств, родительский для скрытого окна. Если тип, заданный в IPropertySheetProvider::CreatePropertySheet , является мастером, IPropertySheetProvider::Show отображает фрейм листа свойств, родительский для дескриптора, передаваемого этому методу.
Синтаксис
HRESULT Show(
[in] LONG_PTR window,
[in] int page
);
Параметры
[in] window
Значение типа , указывающее дескриптор родительского окна.
[in] page
Значение типа , указывающее, какая страница на странице свойств отображается. Индексируется с нуля.
Возвращаемое значение
Этот метод может возвращать одно из этих значений.
Комментарии
IPropertySheetProvider::Show( –1, 0) возвращает E_FAIL. В этом случае этот код возврата можно игнорировать.
В ситуациях, когда оснастка создает страницу свойств при вызове IPropertySheetProvider::CreatePropertySheet, при необходимости вызывает IPropertySheetProvider::AddPrimaryPages и IPropertySheetProvider::AddExtensionPages, а затем решает не отображать страницу свойств, она должна вызвать IPropertySheetProvider::Show( –1, 0), чтобы удалить страницу свойств и освободить ее ресурсы. В этом случае оснастка должна удалить созданные маркеры страницы свойств. Это можно сделать до или после вызова оснастки IPropertySheetProvider::Show( –1, 0), так как MMC не использует дескрипторы страниц свойств.
IPropertySheetProvider::Show( –1, 0) удаляет только текущую страницу свойств, то есть созданную, но еще не показанную. После отображения страницы свойств оснастка не может закрыть ее программным способом. Только пользователь может закрыть отображаемый лист свойств. В этом случае MMC автоматически удаляет все связанные страницы свойств (структуры PROPSHEETPAGE ), предоставляемые оснасткой.
Требования
Требование | Значение |
---|---|
Минимальная версия клиента | Windows Vista |
Минимальная версия сервера | Windows Server 2008 |
Целевая платформа | Windows |
Header | mmc.h |
DLL | Mmcndmgr.dll |