Share via


FILECHANGEINFO (Windows CE 5.0)

Send Feedback

This structure contains information about a file system event.

struct _FILECHANGEINFO {DWORD cbSize;LONG wEventId;ULONG uFlags;DWORD dwItem1;DWORD dwItem2;DWORD dwAttributes;FILETIME ftModified;ULONG nFileSize;} FILECHANGEINFO, *LPFILECHANGEINFO;

Members

  • cbSize
    The size of the FILECHANGEINFO structure.

  • wEventId
    Describes the event that has occurred. Typically, only one event is specified at a time. If more than one event is specified, the values contained in the dwItem1 and dwItem2 parameters must be the same, respectively, for all specified events.

    The following table shows the values for this parameter. The parameter can be one or more of these values.

    Value Description
    SHCNE_RENAMEITEM The name of a non-folder item has changed. SHCNF_PATH must be specified in uFlags. dwItem1 contains a pointer to a string array that stores the name of the item. dwItem2 contains a pointer to a string array that stores the new name of the item.
    SHCNE_CREATE A non-folder item has been created. SHCNF_PATH must be specified in uFlags. dwItem1 contains a pointer to a string array that stores the item that was created. dwItem2 is dwItem2 is not used and should be NULL.
    SHCNE_DELETE A non-folder item has been deleted. SHCNF_PATH must be specified in uFlags. dwItem1 contains a pointer to a string array that stores the item that was deleted. dwItem2 is reserved and should be NULL.
    SHCNE_MKDIR A folder has been created. SHCNF_PATH must be specified in uFlags. dwItem1 contains a pointer to a string array that stores the folder that was created. dwItem2 is reserved and should be NULL.
    SHCNE_RMDIR A folder has been removed. SHCNF_PATH must be specified in uFlags. dwItem1 a pointer to a string array that stores contains the folder that was removed. dwItem2 is reserved and should be NULL.
    SHCNE_MEDIAINSERTED Storage media has been inserted into a drive. SHCNF_PATH must be specified in uFlags. dwItem1 contains a pointer to a string array that stores the root of the drive that contains the new media. dwItem2 is reserved and should be NULL.
    SHCNE_MEDIAREMOVED Storage media has been removed from a drive. SHCNF_PATH must be specified in uFlags. dwItem1 contains a pointer to a string array that stores the root of the drive from which the media was removed. dwItem2 is reserved and should be NULL.
    SHCNE_DRIVEREMOVED A drive has been removed. SHCNF_PATH must be specified in uFlags. dwItem1 contains a pointer to a string array that stores the root of the drive that was removed. dwItem2 is reserved and should be NULL.
    SHCNE_DRIVEADD A drive has been added. SHCNF_PATH must be specified in uFlags. dwItem1 contains a pointer to a string array that stores the root of the drive that was added. dwItem2 is reserved and should be NULL.
    SHCNE_NETSHARE A folder on the local computer is being shared through the network. SHCNF_PATH must be specified in uFlags. dwItem1 contains a pointer to a string array that stores the folder that is being shared. dwItem2 is reserved and should be NULL.

    A connection was made to a remote server. SHCNF_PATH must be specified in uFlags. dwItem1 contains a pointer to a string array that stores the local folder name. dwItem2 contains a pointer to a string array that stores the remote folder name.

    SHCNE_NETUNSHARE A folder on the local computer is no longer being shared through the network. SHCNF_PATH must be specified in uFlags. dwItem1 contains a pointer to a string array that stores the folder that is no longer being shared. dwItem2 is reserved and should be NULL.

    A connection to a server has been removed. SHCNF_PATH must be specified in uFlags. dwItem1 contains a pointer to a string array that stores the local folder name. dwItem2 contains a pointer to a string array that stores the remote folder name.

    SHCNE_ATTRIBUTES The attributes of an item or folder have changed. SHCNF_PATH must be specified in uFlags. dwItem1 contains a pointer to a string array that stores the item or folder that has changed. dwItem2 is reserved and should be NULL.
    SHCNE_UPDATEDIR The contents of an existing folder have changed, but the folder still exists and has not been renamed. SHCNF_PATH must be specified in uFlags. dwItem1 contains a pointer to a string array that stores the folder that has changed. dwItem2 is reserved and should be NULL. If a folder has been created, deleted, or renamed, use SHCNE_MKDIR, SHCNE_RMDIR, or SHCNE_RENAMEFOLDER, respectively, instead.
    SHCNE_UPDATEITEM An existing non-folder item has changed, but the item still exists and has not been renamed. SHCNF_PATH must be specified in uFlags. dwItem1 contains a pointer to a string array that stores the item that has changed. dwItem2 is reserved and should be NULL. If a non-folder item has been created, deleted, or renamed, use SHCNE_CREATE, SHCNE_DELETE, or SHCNE_RENAMEITEM, respectively, instead.
    SHCNE_SERVERDISCONNECT The computer has disconnected from a server. SHCNF_PATH must be specified in uFlags. dwItem1 contains a pointer to a string array that stores the server from which the computer was disconnected. dwItem2 is reserved and should be NULL.
    SHCNE_UPDATEIMAGE An image in the system image list has changed. SHCNF_DWORD must be specified in uFlags. dwItem1 contains the index in the system image list that has changed. dwItem2 is reserved and should be NULL.
    SHCNE_DRIVEADDGUI A drive has been added and the shell should create a new window for the drive. SHCNF_PATH must be specified in uFlags. dwItem1 contains a pointer to a string array that stores the root of the drive that was added. dwItem2 is reserved and should be NULL.
    SHCNE_RENAMEFOLDER The name of a folder has changed. SHCNF_PATH must be specified in uFlags. dwItem1 contains a pointer to a string array that stores the previous name of the folder. dwItem2 contains a pointer to a string array that stores the name of the folder.
    SHCNE_ASSOCCHANGED Not supported.
  • uFlags
    Flags that indicate the meaning of the dwItem1 and dwItem2 parameters. The following table shows the uFlags values. This parameter must be one of these values.

    Value Description
    SHCNF_DWORD The dwItem1 and dwItem2 parameters are DWORD values. This flag is currently not supported.
    SHCNF_IDLIST dwItem1 and dwItem2 are the addresses of ITEMIDLIST structures that represent the item(s) affected by the change. Each ITEMIDLIST must be relative to the desktop folder. This flag is currently not supported.
    SHCNF_PATH dwItem1 and dwItem2 are pointers to string arrays that contain the full path names of the items affected by the change.
    SHCNF_PRINTER dwItem1 and dwItem2 are pointers to string arrays that represent the friendly names of the printers affected by the change. This flag is currently not supported.

    The following table shows flags that modify other data-type flags. These flags cannot be used without one of the previously described values.

    Value Description
    SHCNF_FLUSH The function should not return until the notification has been delivered to all affected components. This flag is not supported but is the default behavior if SHCNF_FLUSHNOWAIT is not specified.
    SHCNF_FLUSHNOWAIT The function should begin delivering notifications to all affected components but should return as soon as the notification process has begun.
  • dwItem1
    First event-dependent value.

  • dwItem2
    Second event-dependent value.

  • dwAttributes
    Attributes of the file, folder, or item.

  • ftModified
    Time when the event occurred.

  • nFileSize
    Size of the file, folder, or item.

Remarks

All memory required for this structure must be allocated and freed by the file system driver (FSD).

Requirements

OS Versions: Windows CE 2.10 and later.
Header: Extfile.h.

See Also

ITEMIDLIST

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.