LPFNVIEWCALLBACK function pointer
[This interface is supported through Windows XP Service Pack 2 (SP2) and Windows Server 2003. It might be unsupported in subsequent versions of Windows.]
Defines the prototype for the callback function used by the system folder view object. This function essentially duplicates the functionality of IShellFolderViewCB.
Syntax
typedef HRESULT ( CALLBACK *LPFNVIEWCALLBACK)(
_In_ IShellView *psvOuter,
_In_ IShellFolder *psf,
_In_ HWND hwndMain,
UINT uMsg,
WPARAM wParam,
LPARAM lParam
);
Parameters
- psvOuter [in]
-
Type: IShellView*
A pointer to the owning instance of IShellView, if applicable. This parameter can be NULL.
- psf [in]
-
Type: IShellFolder*
A pointer to the instance of IShellFolder the message applies to.
- hwndMain [in]
-
Type: HWND
The handle of the window that contains the view that receives the message.
- uMsg
-
Type: UINT
One of the following notifications.
-
Allows the callback object to provide a page to add to the Properties property sheet of the selected object.
-
Allows the callback object to request that enumeration be done on a background thread.
-
Notifies the callback object that background enumeration is complete.
-
Notifies the callback object that the user has clicked a column header to sort the list of objects in the folder view.
-
Allows the callback object to specify the number of items in the folder view.
-
Allows the callback object to specify the view mode.
-
Notifies the callback function that a drag-and-drop operation has begun.
-
Notifies the callback object that an event has taken place that affects one of its items.
-
Allows the callback object to specify that an animation be displayed while items are enumerated on a background thread.
-
Allows the callback object to add buttons to the toolbar.
-
Allows the callback object to specify the buttons to be added to the toolbar.
-
Allows the callback object to provide the details for an item in a Shell folder. Use only if a call to IShellFolder2::GetDetailsOf fails and there is no IShellDetails::GetDetailsOf method available to call.
-
Allows the callback object to specify a help text string for menu items or toolbar buttons.
-
Allows the callback object to specify a Help file and topic.
-
Specifies which events will generate an SFVM_FSNOTIFY message for a given item.
-
Allows the callback object to provide the status bar pane in which to display the Internet zone information.
-
Allows the callback object to specify default sorting parameters.
-
Allows the callback object to specify a tooltip text string for menu items or toolbar buttons.
-
Allows the callback object to provide Internet zone information.
-
Allows the callback object to modify an item's context menu.
-
Notifies the callback object that one of its toolbar or menu commands has been invoked.
-
Allows the callback object to merge menu items into the Windows Explorer menus.
-
Allows the callback object to register a folder so that changes to that folder's view will generate notifications.
-
Notifies the callback object of the container site. This is used only when IObjectWithSite::SetSite is not supported and SHCreateShellFolderViewEx is used.
-
Notifies the callback object that the folder view has been resized.
-
Allows the callback object to specify the view's PIDL. This is used only when IPersistIDList::SetIDList and IPersistFolder2::GetCurFolder have failed.
-
Notifies the callback object that a menu is being removed.
-
Allows the callback object to request that the status bar be updated.
-
Notifies the callback object that the folder view window is being created.
- wParam
-
Type: WPARAM
Additional information dependent on the value in uMsg. See the individual notification pages for specific requirements.
- lParam
-
Type: LPARAM
Additional information dependent on the value in uMsg. See the individual notification pages for specific requirements.
Return value
Type: HRESULT
If this function pointer succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.
Requirements
|
Minimum supported client |
Windows 2000 Professional [desktop apps only] |
|---|---|
|
Minimum supported server |
Windows 2000 Server [desktop apps only] |
|
Header |
|
See also