IShellBrowser::SendControlMsg

[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.

See Also

IShellBrowser