Edit

IShellBrowser::SendControlMsg method (shobjidl_core.h)

  • Article

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

Requirement Value
Minimum supported client Windows XP [desktop apps only]
Minimum supported server Windows 2000 Server [desktop apps only]
Target Platform Windows
Header shobjidl_core.h (include Shobjidl.h)
DLL Shell32.dll (version 4.0 or later)

See also

IShellBrowser