IControlbar::Create method (mmc.h)

The IControlbar::Create method creates and returns the control requested by the snap-in.

Syntax

HRESULT Create(
  [in]  MMC_CONTROL_TYPE   nType,
  [in]  LPEXTENDCONTROLBAR pExtendControlbar,
  [out] LPUNKNOWN          *ppUnknown
);

Parameters

[in] nType

A value that specifies the type of control to be associated; taken from the MMC_CONTROL_TYPE enumeration.

[in] pExtendControlbar

A pointer to the snap-in's IExtendControlbar interface that is to be associated with the control (toolbar or menu button) that will be created. Notifications generated by the new control will be sent to IExtendControlBar::ControlbarNotify.

[out] ppUnknown

A pointer to the address of the IUnknown interface of the control that was created.

Return value

This method can return one of these values.

Remarks

The IControlbar::Create method increments the reference count on the control bar object it creates, so the snap-in is not required to call the AddRef method on the interface.

Although COMBOBOXBAR is included in Mmc.idl in connection with the nType parameter, it is not implemented.

Requirements

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

See also

IToolbar