SHCHANGENOTIFYENTRY

  • Article

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

This structure indicates which events will result in notifications to the subscribing window for a watched directory or directory tree.

Syntax

typedef struct tagSHCHANGENOTIFYENTRY {
  DWORD dwEventMask;
  LPTSTR pszWatchDir;
  BOOL fRecursive;
} SHCHANGENOTIFYENTRY;

Members

  • dwEventMask
    Specifies the events for which a notification should be sent. This member can contain any combination of events shown in the following table.

    Event Name Description

    SHCNE_RENAMEITEM

    The name of a non-folder item has changed.

    SHCNE_CREATE

    A non-folder item has been created.

    SHCNE_DELETE

    A non-folder item has been deleted.

    SHCNE_MKDIR

    A folder has been created.

    SHCNE_RMDIR

    A folder has been deleted.

    SHCNE_MEDIAINSERTED

    Storage media has been inserted into a drive.

    SHCNE_MEDIAREMOVED

    Storage media has been removed from a drive.

    SHCNE_DRIVEREMOVED

    An SD card has been removed (SD cards are considered to be drives).

    SHCNE_DRIVEADD

    An SD card has been inserted (SD cards are considered to be drives).

    SHCNE_NETSHARE

    A folder on the local device is being shared on the network.

    SHCNE_NETUNSHARE

    A folder on the local device is no longer being shared on the network.

    SHCNE_ATTRIBUTES

    The attributes of an item or folder have changed.

    SHCNE_UPDATEDIR

    The contents of an existing folder have changed, but the folder was not renamed or deleted.

    SHCNE_UPDATEITEM

    A non-folder item has changed, but was not renamed or deleted.

    SHCNE_SERVERDISCONNECT

    Not supported.

    SHCNE_RENAMEFOLDER

    The name of a folder has changed.

    SHCNE_ALLEVENTS

    Use this to request notification for all events.
  • pszWatchDir
    Fully qualified path to the directory or root for which notifications are requested. Set this member to NULL to request notifications for changes anywhere in the file system. If fRecursive is TRUE, then notifications are requested for pszWatchDir and the related subdirectories.
  • fRecursive
    Not supported. For Windows Mobile, this member indicates whether notifications are requested for just pszWatchDir or pszWatchDir and all of the related subdirectories.

Remarks

For this structure is defined in the Shlobj.h header file and ceshell.lib DLL.

Requirements

Header aygshell.h
Windows Embedded CE Windows CE .NET 4.2 and later
Windows Mobile Windows Mobile Version 5.0 and later