mirror of https://github.com/dahall/Vanara.git
Added SHChangeNotify
David Hall
parent
749b5af680
commit
f654f77e73
|
|
@ -106,6 +106,176 @@ namespace Vanara.PInvoke
|
|||
SHARD_SHELLITEM = 8
|
||||
}
|
||||
|
||||
/// <summary>Events used in SHChangeNotify.</summary>
|
||||
[PInvokeData("Shlobj_core.h")]
|
||||
[Flags]
|
||||
public enum SHCNE : uint
|
||||
{
|
||||
/// <summary>
|
||||
/// The name of a nonfolder item has changed. SHCNF_IDLIST or SHCNF_PATH must be specified in uFlags. dwItem1 contains the
|
||||
/// previous PIDL or name of the item. dwItem2 contains the new PIDL or name of the item.
|
||||
/// </summary>
|
||||
SHCNE_RENAMEITEM = 0x00000001,
|
||||
/// <summary>
|
||||
/// A nonfolder item has been created. SHCNF_IDLIST or SHCNF_PATH must be specified in uFlags. dwItem1 contains the item that was
|
||||
/// created. dwItem2 is not used and should be NULL.
|
||||
/// </summary>
|
||||
SHCNE_CREATE = 0x00000002,
|
||||
/// <summary>
|
||||
/// A nonfolder item has been deleted. SHCNF_IDLIST or SHCNF_PATH must be specified in uFlags. dwItem1 contains the item that was
|
||||
/// deleted. dwItem2 is not used and should be NULL.
|
||||
/// </summary>
|
||||
SHCNE_DELETE = 0x00000004,
|
||||
/// <summary>
|
||||
/// A folder has been created. SHCNF_IDLIST or SHCNF_PATH must be specified in uFlags. dwItem1 contains the folder that was
|
||||
/// created. dwItem2 is not used and should be NULL.
|
||||
/// </summary>
|
||||
SHCNE_MKDIR = 0x00000008,
|
||||
/// <summary>
|
||||
/// A folder has been removed. SHCNF_IDLIST or SHCNF_PATH must be specified in uFlags. dwItem1 contains the folder that was
|
||||
/// removed. dwItem2 is not used and should be NULL.
|
||||
/// </summary>
|
||||
SHCNE_RMDIR = 0x00000010,
|
||||
/// <summary>
|
||||
/// Storage media has been inserted into a drive. SHCNF_IDLIST or SHCNF_PATH must be specified in uFlags. dwItem1 contains the
|
||||
/// root of the drive that contains the new media. dwItem2 is not used and should be NULL.
|
||||
/// </summary>
|
||||
SHCNE_MEDIAINSERTED = 0x00000020,
|
||||
/// <summary>
|
||||
/// Storage media has been removed from a drive. SHCNF_IDLIST or SHCNF_PATH must be specified in uFlags. dwItem1 contains the
|
||||
/// root of the drive from which the media was removed. dwItem2 is not used and should be NULL.
|
||||
/// </summary>
|
||||
SHCNE_MEDIAREMOVED = 0x00000040,
|
||||
/// <summary>
|
||||
/// A drive has been removed. SHCNF_IDLIST or SHCNF_PATH must be specified in uFlags. dwItem1 contains the root of the drive that
|
||||
/// was removed. dwItem2 is not used and should be NULL.
|
||||
/// </summary>
|
||||
SHCNE_DRIVEREMOVED = 0x00000080,
|
||||
/// <summary>
|
||||
/// A drive has been added. SHCNF_IDLIST or SHCNF_PATH must be specified in uFlags. dwItem1 contains the root of the drive that
|
||||
/// was added. dwItem2 is not used and should be NULL.
|
||||
/// </summary>
|
||||
SHCNE_DRIVEADD = 0x00000100,
|
||||
/// <summary>
|
||||
/// A folder on the local computer is being shared via the network. SHCNF_IDLIST or SHCNF_PATH must be specified in uFlags.
|
||||
/// dwItem1 contains the folder that is being shared. dwItem2 is not used and should be NULL.
|
||||
/// </summary>
|
||||
SHCNE_NETSHARE = 0x00000200,
|
||||
/// <summary>
|
||||
/// A folder on the local computer is no longer being shared via the network. SHCNF_IDLIST or SHCNF_PATH must be specified in
|
||||
/// uFlags. dwItem1 contains the folder that is no longer being shared. dwItem2 is not used and should be NULL.
|
||||
/// </summary>
|
||||
SHCNE_NETUNSHARE = 0x00000400,
|
||||
/// <summary>
|
||||
/// The attributes of an item or folder have changed. SHCNF_IDLIST or SHCNF_PATH must be specified in uFlags. dwItem1 contains
|
||||
/// the item or folder that has changed. dwItem2 is not used and should be NULL.
|
||||
/// </summary>
|
||||
SHCNE_ATTRIBUTES = 0x00000800,
|
||||
/// <summary>
|
||||
/// The contents of an existing folder have changed, but the folder still exists and has not been renamed. SHCNF_IDLIST or
|
||||
/// SHCNF_PATH must be specified in uFlags. dwItem1 contains the folder that has changed. dwItem2 is not used and should be NULL.
|
||||
/// If a folder has been created, deleted, or renamed, use SHCNE_MKDIR, SHCNE_RMDIR, or SHCNE_RENAMEFOLDER, respectively.
|
||||
/// </summary>
|
||||
SHCNE_UPDATEDIR = 0x00001000,
|
||||
/// <summary>
|
||||
/// An existing item (a folder or a nonfolder) has changed, but the item still exists and has not been renamed. SHCNF_IDLIST or
|
||||
/// SHCNF_PATH must be specified in uFlags. dwItem1 contains the item that has changed. dwItem2 is not used and should be NULL.
|
||||
/// If a nonfolder item has been created, deleted, or renamed, use SHCNE_CREATE, SHCNE_DELETE, or SHCNE_RENAMEITEM, respectively, instead.
|
||||
/// </summary>
|
||||
SHCNE_UPDATEITEM = 0x00002000,
|
||||
/// <summary>
|
||||
/// The computer has disconnected from a server. SHCNF_IDLIST or SHCNF_PATH must be specified in uFlags. dwItem1 contains the
|
||||
/// server from which the computer was disconnected. dwItem2 is not used and should be NULL.
|
||||
/// </summary>
|
||||
SHCNE_SERVERDISCONNECT = 0x00004000,
|
||||
/// <summary>
|
||||
/// An image in the system image list has changed. SHCNF_DWORD must be specified in uFlags. dwItem2 contains the index in the
|
||||
/// system image list that has changed. dwItem1 is not used and should be NULL.
|
||||
/// </summary>
|
||||
SHCNE_UPDATEIMAGE = 0x00008000,
|
||||
/// <summary>
|
||||
/// A drive has been added. SHCNF_IDLIST or SHCNF_PATH must be specified in uFlags. dwItem1 contains the root of the drive that
|
||||
/// was added. dwItem2 is not used and should be NULL.
|
||||
/// </summary>
|
||||
SHCNE_DRIVEADDGUI = 0x00010000,
|
||||
/// <summary>
|
||||
/// The name of a folder has changed. SHCNF_IDLIST or SHCNF_PATH must be specified in uFlags. dwItem1 contains the previous PIDL
|
||||
/// or name of the folder. dwItem2 contains the new PIDL or name of the folder.
|
||||
/// </summary>
|
||||
SHCNE_RENAMEFOLDER = 0x00020000,
|
||||
/// <summary>
|
||||
/// The amount of free space on a drive has changed. SHCNF_IDLIST or SHCNF_PATH must be specified in uFlags. dwItem1 contains the
|
||||
/// root of the drive on which the free space changed. dwItem2 is not used and should be NULL.
|
||||
/// </summary>
|
||||
SHCNE_FREESPACE = 0x00040000,
|
||||
/// <summary>Not currently used.</summary>
|
||||
SHCNE_EXTENDED_EVENT = 0x04000000,
|
||||
/// <summary>
|
||||
/// A file type association has changed. SHCNF_IDLIST must be specified in the uFlags parameter. dwItem1 and dwItem2 are not used
|
||||
/// and must be NULL. This event should also be sent for registered protocols.
|
||||
/// </summary>
|
||||
SHCNE_ASSOCCHANGED = 0x08000000,
|
||||
/// <summary>All disk related events.</summary>
|
||||
SHCNE_DISKEVENTS = 0x0002381F,
|
||||
/// <summary>All global events.</summary>
|
||||
SHCNE_GLOBALEVENTS = 0x0C0581E0,
|
||||
/// <summary>All events.</summary>
|
||||
SHCNE_ALLEVENTS = 0x7FFFFFFF,
|
||||
/// <summary>
|
||||
/// The presence of this flag indicates that the event was generated by an interrupt. It is stripped out before the clients of
|
||||
/// SHCNNotify_ see it.
|
||||
/// </summary>
|
||||
SHCNE_INTERRUPT = 0x80000000,
|
||||
}
|
||||
|
||||
/// <summary>Flags used in SHChangeNotify.</summary>
|
||||
[PInvokeData("Shlobj_core.h")]
|
||||
[Flags]
|
||||
public enum SHCNF : uint
|
||||
{
|
||||
/// <summary>
|
||||
/// 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.
|
||||
/// </summary>
|
||||
SHCNF_IDLIST = 0x0000,
|
||||
/// <summary>
|
||||
/// dwItem1 and dwItem2 are the addresses of null-terminated strings of maximum length MAX_PATH that contain the full path names
|
||||
/// of the items affected by the change.
|
||||
/// </summary>
|
||||
SHCNF_PATHA = 0x0001,
|
||||
/// <summary>
|
||||
/// dwItem1 and dwItem2 are the addresses of null-terminated strings that represent the friendly names of the printer(s) affected
|
||||
/// by the change.
|
||||
/// </summary>
|
||||
SHCNF_PRINTERA = 0x0002,
|
||||
/// <summary>The dwItem1 and dwItem2 parameters are DWORD values.</summary>
|
||||
SHCNF_DWORD = 0x0003,
|
||||
/// <summary>
|
||||
/// dwItem1 and dwItem2 are the addresses of null-terminated strings of maximum length MAX_PATH that contain the full path names
|
||||
/// of the items affected by the change.
|
||||
/// </summary>
|
||||
SHCNF_PATHW = 0x0005,
|
||||
/// <summary>
|
||||
/// dwItem1 and dwItem2 are the addresses of null-terminated strings that represent the friendly names of the printer(s) affected
|
||||
/// by the change.
|
||||
/// </summary>
|
||||
SHCNF_PRINTERW = 0x0006,
|
||||
/// <summary>Indicates that a type is defined.</summary>
|
||||
SHCNF_TYPE = 0x00FF,
|
||||
/// <summary>
|
||||
/// The function should not return until the notification has been delivered to all affected components. As this flag modifies
|
||||
/// other data-type flags, it cannot be used by itself.
|
||||
/// </summary>
|
||||
SHCNF_FLUSH = 0x1000,
|
||||
/// <summary>
|
||||
/// The function should begin delivering notifications to all affected components but should return as soon as the notification
|
||||
/// process has begun. As this flag modifies other data-type flags, it cannot by used by itself. This flag includes SHCNF_FLUSH.
|
||||
/// </summary>
|
||||
SHCNF_FLUSHNOWAIT = 0x3000,
|
||||
/// <summary>Notify clients registered for all children.</summary>
|
||||
SHCNF_NOTIFYRECURSIVE = 0x10000
|
||||
}
|
||||
|
||||
/// <summary>Receives a value that determines what type the item is in <see cref="SHDESCRIPTIONID"/>.</summary>
|
||||
[PInvokeData("Shlobj_core.h", MSDNShortId = "bb759775")]
|
||||
public enum SHDID
|
||||
|
|
@ -341,6 +511,21 @@ namespace Vanara.PInvoke
|
|||
[PInvokeData("Shlobj.h", MSDNShortId = "bb762115")]
|
||||
public static extern PIDL SHBrowseForFolder(ref BROWSEINFO lpbi);
|
||||
|
||||
/// <summary>
|
||||
/// 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.
|
||||
/// </summary>
|
||||
/// <param name="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.
|
||||
/// </param>
|
||||
/// <param name="uFlags">Flags that, when combined bitwise with SHCNF_TYPE, indicate the meaning of the dwItem1 and dwItem2 parameters.</param>
|
||||
/// <param name="dwItem1">Optional. First event-dependent value.</param>
|
||||
/// <param name="dwItem2">Optional. Second event-dependent value.</param>
|
||||
[DllImport(Lib.Shell32, ExactSpelling = true)]
|
||||
[PInvokeData("Shlobj.h")]
|
||||
public static extern void SHChangeNotify(SHCNE wEventId, SHCNF uFlags, [Optional] IntPtr dwItem1, [Optional] IntPtr dwItem2);
|
||||
|
||||
/// <summary>Creates a new instance of the default Shell folder view object (DefView).</summary>
|
||||
/// <param name="pcsfv">Pointer to a SFV_CREATE structure that describes the particulars used in creating this instance of the Shell folder view object.</param>
|
||||
/// <param name="ppsv">When this function returns successfully, contains an interface pointer to the new IShellView object. On failure, this value is NULL.</param>
|
||||
|
|
|
|||
Loading…
Reference in New Issue