SHShellFolderView_Message function (shlobj_core.h)

[SHShellFolderView_Message is available for use in the operating systems specified in the Requirements section. It may be altered or unavailable in subsequent versions.]

Sends a message to the shell's default IFolderView implementation (DefView).


LRESULT SHShellFolderView_Message(
  [in] HWND   hwndMain,
       UINT   uMsg,
       LPARAM lParam


[in] hwndMain

Type: HWND

A handle to the window that receives the message.


Type: UINT

The message to send. The following is a list of possible messages.

Message Description
SFVM_ADDOBJECT Adds an object to the shell view.
SFVM_GETSELECTEDOBJECTS Retrieves an array of PIDLs for all selected objects.
SFVM_REARRANGE Notifies the IShellView to rearrange its items.
SFVM_REMOVEOBJECT Removes an object from the shell view.
SFVM_SETCLIPBOARD Notifies the IShellView when one of its objects is placed on the clipboard as a result of a menu command.
SFVM_SETITEMPOS Sets the position of an item in the shell view.
SFVM_SETPOINTS Sets the points of the currently selected objects to the data object on copy and cut commands.
SFVM_UPDATEOBJECT Updates an object by passing a pointer to an array of two PIDLs.



Contents of this value depend on the message passed in uMsg. See individual message topics for more information.

Return value


The return value depends on the message passed in uMsg. See individual message topics for more information.


Minimum supported client Windows XP [desktop apps only]
Minimum supported server Windows Server 2003 [desktop apps only]
Target Platform Windows
Header shlobj_core.h (include Shlobj.h)
Library Shell32.lib
DLL Shell32.dll (version 5.0 or later)

See also