IShellBrowser::SendControlMsg method (shobjidl_core.h)
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) |