IDockingWindowFrame::FindToolbar method

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

pwszItem [in]

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.

riid [in]

Type: REFIID

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

ppv [out]

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

Minimum supported client

Windows 2000 Professional, Windows XP [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

Header

Shlobj.h

DLL

Shell32.dll (version 4.71 or later)

See also

IDockingWindowFrame
IDockingWindowSite

 

 

Show: