Edit

SHShellFolderView_Message function (shlobj_core.h)

  • Article

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

Syntax

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

Parameters

[in] hwndMain

Type: HWND

A handle to the window that receives the message.

uMsg

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.

lParam

Type: LPARAM

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

Return value

Type: LRESULT

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

Requirements

Requirement Value
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

SHCreateShellFolderView