IExtendPropertySheet：：CreatePropertyPages 方法 (mmc.h)

發行項
08/24/2023

將頁面加入至屬性工作表。

語法

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

參數

[in] lpProvider

IPropertySheetCallback介面的指標。

[in] handle

值，指定用來將 MMCN_PROPERTY_CHANGE 通知訊息路由傳送至適當的 IComponent 或 IComponentData 介面的控制碼。

針對直接使用 IPropertySheetProvider 介面的嵌入式管理單元，MMC 會在嵌入式管理單元呼叫 IPropertySheetProvider：：AddPrimaryPages 並指定其 bCreateHandle 為 TRUE時建立控制碼。

[in] lpIDataObject

物件上 IDataObject 介面的指標，其中包含範圍或結果專案的內容資訊。

傳回值

這個方法可以傳回下列其中一個值。

備註

IPropertySheetCallback 介面會在呼叫此方法期間傳遞至嵌入式管理單元。此介面的存留期受 MMC 控制。因此，指標 lpIDataObject 只有在立即呼叫這個方法的存留期內才有效。不建議在回呼外部快取 lpIDataObject 指標值。

handle 參數指定的控制碼必須儲存在屬性頁物件中，才能使用 API 函式 MMCPropertyChangeNotify通知屬性變更的父系。

如果嵌入式管理單元傳回成功程式碼 (S_OK，S_FALSE) 來自 CreatePropertyPages，則嵌入式管理單元必須呼叫 MMCFreeNotifyHandle。如果嵌入式管理單元傳回錯誤碼，MMC 會立即釋放控制碼。如需何時應呼叫 MMCFreeNotifyHandle 的詳細資訊，請參閱 MMCFreeNotifyHandle。