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::AddPrimaryPagesIPropertySheetProvider::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

另请参阅

IPropertySheetProvider