[Now Supported on Windows NT]
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.