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 |
标头 | mmc.h |
DLL | Mmcndmgr.dll |