IDockingWindowFrame::RemoveToolbar method (shlobj.h)

Removes the specified IDockingWindow from the toolbar frame.

Syntax

HRESULT RemoveToolbar(
  [in] IUnknown *punkSrc,
       DWORD    dwRemoveFlags
);

Parameters

[in] punkSrc

Type: IUnknown*

Pointer to the IDockingWindow object to be removed. The IDockingWindowFrame implementation calls the IDockingWindow::CloseDW and IDockingWindow::Release methods.

dwRemoveFlags

Type: DWORD

Option flags for removing the docking window object. This parameter can be one or more of the following values:

DWFRF_NORMAL (0x0000)

The default delete processing is performed.

DWFRF_DELETECONFIGDATA (0x0001)

In addition to deleting the toolbar, any configuration data is removed as well.

Return value

Type: HRESULT

If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Requirements

Requirement Value
Minimum supported client Windows 2000 Professional, Windows XP [desktop apps only]
Minimum supported server Windows 2000 Server [desktop apps only]
Target Platform Windows
Header shlobj.h
DLL Shell32.dll (version 4.71 or later)

See also

IDockingWindowFrame

IDockingWindowSite