IShellBrowser::SendControlMsg

Quick Info

Windows NT
Yes
Win95
Yes
Win32s
No
Import Library
-
Header File
shlobj.h
Unicode
No
Platform Notes
None

[Now Supported on Windows NT]

SendControlMsg can be called by the shell view object to send control messages to an Explorer control, either for a toobar or for a status bar window.

HRESULT SendControlMsg(

UINT id,	// Identifies a control
UINT uMsg,	// Specifies the message to be sent
WPARAM wParam,	// Depends on uMsg
LPARAM lParam,	// Depends on uMsg
LRESULT *pref	// Points to the SendMessage return value
);

Parameters
id
Specifies the identifer for either a toolbar (FCW_TOOLBAR) or for a status bar window (FCW_STATUS).

uMsg
Specifies the message to be sent to the control.

wParam

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

lParam

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

pret

Pointer to the return value of the SendMessage function.

Return Values
Returns NOERROR if successful or an OLE-defined error value otherwise.

Remarks
Refer to the commctrl.h header file to find the messages that can be sent to the toolbar or status bar control.

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

Notes to Implementors
If your Explorer does not have these controls you can return E_NOTIMPL.