IShellBrowser::SendControlMsg method

Sends control messages to either the toolbar or the status bar in a Windows Explorer window.

Syntax


HRESULT SendControlMsg(
   UINT    id,
   UINT    uMsg,
   WPARAM  wParam,
   LPARAM  lParam,
   LRESULT *pret
);

Parameters

id

Type: UINT

An identifier for either a toolbar (FCW_TOOLBAR) or for a status bar window (FCW_STATUS).

uMsg

Type: UINT

The message to be sent to the control.

wParam

Type: WPARAM

The value depends on the message specified in the uMsg parameter.

lParam

Type: LPARAM

The value depends on the message specified in the uMsg parameter.

pret

Type: LRESULT*

The address of the return value of the SendMessage function.

Return value

Type: HRESULT

Returns S_OK if successful, or a COM-defined error value otherwise.

Remarks

Refer to the Common Controls documentation for more information on the messages that can be sent to the toolbar or status bar control.

Notes to Calling Applications

Use of this call requires diligent attention, because leaving either the status bar or toolbar in an inappropriate state will affect the performance of Windows Explorer.

Notes to Implementers

If your Windows Explorer does not have these controls, you can return E_NOTIMPL.

Requirements

Minimum supported client

Windows XP [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

Header

Shobjidl.h

IDL

Shobjidl.idl

DLL

Shell32.dll (version 4.0 or later)

See also

IShellBrowser

 

 

Show: