Prev Next

SHChangeNotify info

Notifies the system of an event that an application has performed. An application should use this function if it performs an action that may affect the shell.

WINSHELLAPI void WINAPI SHChangeNotify(

    LONG wEventId,

    UINT uFlags,

    LPCVOID dwItem1,

    LPCVOID dwItem2

   );

Parameters

wEventId
Array of flags that specifies the events. This parameter can be a combination of the following values:

SHCNE_ASSOCCHANGED

Changed a file type association.

SHCNE_ATTRIBUTES

Changed a file’s attributes.

SHCNE_CREATE

Created a file.

SHCNE_DELETE

Deleted a file.

SHCNE_DRIVEADD

Added a network drive.

SHCNE_DRIVEADDGUI

Added a network drive by way of a graphic user interface.

SHCNE_DRIVEREMOVED

Removed a network drive.

SHCNE_INTERRUPT

Performed the event as a result of a system interrupt.

SHCNE_MEDIAINSERTED

Added removable media, such as a CD-ROM.

SHCNE_MEDIAREMOVED

Removed a removable medium, such as a CD-ROM.

SHCNE_MKDIR

Created a new directory.

SHCNE_NETSHARE

Shared a resource on the network.

SHCNE_NETUNSHARE

Stopped sharing a resource.

SHCNE_RENAMEFOLDER

Renamed a folder.

SHCNE_RENAMEITEM

Renamed an item in a folder.

SHCNE_RMDIR

Removed a directory.

SHCNE_SERVERDISCONNECT

Disconnected a network server.

SHCNE_UPDATEDIR

Updated the contents of a directory.

SHCNE_UPDATEIMAGE

Changed an image in the system global image list.

SHCNE_UPDATEITEM

Changed the properties of a printer or file.

uFlags
Flag that indicates the meaning of dwItem1 and dwItem2. This parameter can be one of the following values:

SHCNF_DWORD

The dwItem1 and dwItem2 parameters are doubleword values.

SHCNF_FLUSH

Flushes the system event buffer. The function does not return until the system is finished processing the given event.

SHCNF_FLUSHNOWAIT

Flushes the system event buffer. The function returns immediately regardless of whether the system is finished processing the given event.

SHCNF_IDLIST

dwItem1 and dwItem2 are the addresses of item identifier lists.

SHCNF_PATH

dwItem1 and dwItem2 are path names.

SHCNF_PRINTER

dwItem1 and dwItem2 are printer “friendly” names.

dwItem1
First event-dependent value.
dwItem2
Second event-dependent value.

Return Values

No return value.

See: