IShellBrowser::GetControlWindow

[Now Supported on Windows NT]

GetControlWindow can be called by the shell view object to get the window handle of an Explorer control, either for a toolbar or for a status window.

HRESULT GetControlWindow(

UINT id, // Identifier of an Explorer control
HWND *lphwnd // Handle of the control's window
);  

Parameters

id

Specifies the identifer for either a toolbar (FCW_TOOLBAR), for a status window (FCW_STATUS), or for a tree (FCW_TREE).

lphwnd

Pointer to the window handle of the Explorer control.

Return Values

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

Remarks

GetControlWindow is used so views can directly manipulate the toolbar and status bar. FCW_TREE should be used only to sense whether the tree is present; that is, whether the folder is in Explorer mode or folder mode.

Notes to Callers

This is used to manipulate and test the state of these windows. Do not send messages directly to these controls; instead, use IShellBrowser::SendControlMsg. Be prepared for the returns of this call to be NULL. Future versions of the Explorer may not include a toolbar, status bar, or tree window.

Notes to Implementors

IShellBrowser::GetControlWindow returns the hwnds of these controls if they exist in your implementation.

See Also

IShellBrowser