IExtendPropertySheet：：CreatePropertyPages 方法 (mmc.h)

项目
08/24/2023

向属性表添加页。

语法

HRESULT CreatePropertyPages(
  [in] LPPROPERTYSHEETCALLBACK lpProvider,
  [in] LONG_PTR                handle,
  [in] LPDATAOBJECT            lpIDataObject
);

parameters

[in] lpProvider

指向 IPropertySheetCallback 接口的指针。

[in] handle

一个值，该值指定用于将 MMCN_PROPERTY_CHANGE 通知消息路由到相应的 IComponent 或 IComponentData 接口的句柄。

对于直接使用 IPropertySheetProvider 接口的管理单元，当管理单元调用 IPropertySheetProvider：：AddPrimaryPages 并将其 bCreateHandle 指定为 TRUE 时，MMC 会创建句柄。

[in] lpIDataObject

指向对象上的 IDataObject 接口的指针，该接口包含有关范围或结果项的上下文信息。

返回值

此方法可以返回其中一个值。

注解

在调用此方法期间，IPropertySheetCallback 接口将传递到管理单元。此接口的生存期由 MMC 控制。因此，指针 lpIDataObject 仅在立即调用此方法的生存期内有效。不建议在回调外部缓存 lpIDataObject 指针值。

句柄参数指定的句柄必须保存在属性页对象中，以便使用 API 函数 MMCPropertyChangeNotify 通知父级属性更改。

如果管理单元返回成功代码 (S_OK，S_FALSE) CreatePropertyPages，则管理单元必须调用 MMCFreeNotifyHandle。如果管理单元返回错误代码，MMC 会立即释放句柄。有关何时应调用 MMCFreeNotifyHandle 的详细信息，请参阅 MMCFreeNotifyHandle。