IDockingWindowFrame::FindToolbar method (shlobj.h)

Finds the specified IDockingWindow object in the toolbar frame and returns an interface pointer to it.

Syntax

HRESULT FindToolbar(
  [in]  PCWSTR pwszItem,
  [in]  REFIID riid,
  [out] void   **ppv
);

Parameters

[in] pwszItem

Type: PCWSTR

A pointer to a null-terminated, Unicode, application-defined string used to identify the object. This is the same string that was passed to the AddToolbar method.

[in] riid

Type: REFIID

A reference to the desired interface ID. This is typically IID_IDockingWindow.

[out] ppv

Type: void**

When this method returns, contains the interface pointer requested in riid. This is typically IDockingWindow. If an error occurs, this value receives a null pointer.

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