IPropertySheetProvider::AddPrimaryPages method (mmc.h)

Article
10/13/2021

The IPropertySheetProvider::AddPrimaryPages method collects the pages from the primary snap-in.

Syntax

HRESULT AddPrimaryPages(
  [in] LPUNKNOWN lpUnknown,
  [in] BOOL      bCreateHandle,
  [in] HWND      hNotifyWindow,
  [in] BOOL      bScopePane
);

Parameters

[in] lpUnknown

A pointer to snap-in interface that will be queried for the IExtendPropertySheet interface. If bCreateHandle is set to TRUE, this should also be a pointer to the snap-in's IComponent or IComponentData interface that will be queried for IExtendPropertySheet. Be aware that this value can be NULL. See Remarks for details.

[in] bCreateHandle

A value that specifies whether to create a console-provided notification handle that is used to route the MMCN_PROPERTY_CHANGE notification to the appropriate IComponent or IComponentData interface during calls to MMCPropertyChangeNotify. The notification handle is passed back to the snap-in during calls to the snap-in's implementation of the IExtendPropertySheet2::CreatePropertyPages method.

If bCreateHandle is set to TRUE, the lpUnknown parameter should be a pointer to the IComponent or IComponentData that receives the MMCN_PROPERTY_CHANGE notification.

[in] hNotifyWindow

Reserved for future use. This value should be NULL.

[in] bScopePane

Set to TRUE if the item is in the scope pane. Set to FALSE if it is in the result pane.

Return value

This method can return one of these values.

Remarks

The snap-in might not add any pages during this method call. If this is the case, extension pages should not be added.

Requirements

Requirement	Value
Minimum supported client	Windows Vista
Minimum supported server	Windows Server 2008
Target Platform	Windows
Header	mmc.h
DLL	Mmcndmgr.dll