IExtendControlbar::SetControlbar method (mmc.h)
The IExtendControlbar::SetControlbar method attaches or detaches a control bar.
Syntax
HRESULT SetControlbar(
[in] LPCONTROLBAR pControlbar
);
Parameters
[in] pControlbar
A pointer to an IControlbar interface on the control bar object to be set. A non-NULL value attaches a control bar; a NULL value detaches a control bar.
Return value
This method can return one of these values.
Remarks
As items are selected and deselected, snap-ins are activated and deactivated. When a snap-in is activated, the console calls SetControlbar with a non-NULL pControlbar value. The snap-in should call AddRef on this IControlBar. The snap-in should also use this opportunity to attach controls. Similarly, when the snap-in is deactivated, the console calls SetControlbar with a NULL pControlbar. The snap-in should then detach its controls and call Release on the saved IControlBar.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows Vista |
| Minimum supported server | Windows Server 2008 |
| Target Platform | Windows |
| Header | mmc.h |