code.grnet.gr Git - pithos-ms-client/blob - trunk/Pithos.Client.WPF/NativeMethods.cs

   1 #region
   2 /* -----------------------------------------------------------------------
   3  * <copyright file="NativeMethods.cs" company="GRNet">
   4  *
   5  * Copyright 2011-2012 GRNET S.A. All rights reserved.
   6  *
   7  * Redistribution and use in source and binary forms, with or
   8  * without modification, are permitted provided that the following
   9  * conditions are met:
  10  *
  11  *   1. Redistributions of source code must retain the above
  12  *      copyright notice, this list of conditions and the following
  13  *      disclaimer.
  14  *
  15  *   2. Redistributions in binary form must reproduce the above
  16  *      copyright notice, this list of conditions and the following
  17  *      disclaimer in the documentation and/or other materials
  18  *      provided with the distribution.
  19  *
  20  *
  21  * THIS SOFTWARE IS PROVIDED BY GRNET S.A. ``AS IS'' AND ANY EXPRESS
  22  * OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
  23  * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
  24  * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL GRNET S.A OR
  25  * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
  26  * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
  27  * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
  28  * USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED
  29  * AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
  30  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
  31  * ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
  32  * POSSIBILITY OF SUCH DAMAGE.
  33  *
  34  * The views and conclusions contained in the software and
  35  * documentation are those of the authors and should not be
  36  * interpreted as representing official policies, either expressed
  37  * or implied, of GRNET S.A.
  38  * </copyright>
  39  * -----------------------------------------------------------------------
  40  */
  41 #endregion
  42 using System;
  43 using System.Runtime.InteropServices;
  44
  45 namespace Pithos.Client.WPF
  46 {
  47     #region Enums & Structs
  48
  49     #region enum HChangeNotifyEventID
  50     /// <summary>
  51     /// Describes the event that has occurred.
  52     /// Typically, only one event is specified at a time.
  53     /// If more than one event is specified, the values contained
  54     /// in the <i>dwItem1</i> and <i>dwItem2</i>
  55     /// parameters must be the same, respectively, for all specified events.
  56     /// This parameter can be one or more of the following values.
  57     /// </summary>
  58     /// <remarks>
  59     /// <para><b>Windows NT/2000/XP:</b> <i>dwItem2</i> contains the index
  60     /// in the system image list that has changed.
  61     /// <i>dwItem1</i> is not used and should be <see langword="null"/>.</para>
  62     /// <para><b>Windows 95/98:</b> <i>dwItem1</i> contains the index
  63     /// in the system image list that has changed.
  64     /// <i>dwItem2</i> is not used and should be <see langword="null"/>.</para>
  65     /// </remarks>
  66     [Flags]
  67     enum HChangeNotifyEventID
  68     {
  69         /// <summary>
  70         /// All events have occurred.
  71         /// </summary>
  72         SHCNE_ALLEVENTS = 0x7FFFFFFF,
  73
  74         /// <summary>
  75         /// A file type association has changed. <see cref="HChangeNotifyFlags.SHCNF_IDLIST"/>
  76         /// must be specified in the <i>uFlags</i> parameter.
  77         /// <i>dwItem1</i> and <i>dwItem2</i> are not used and must be <see langword="null"/>.
  78         /// </summary>
  79         SHCNE_ASSOCCHANGED = 0x08000000,
  80
  81         /// <summary>
  82         /// The attributes of an item or folder have changed.
  83         /// <see cref="HChangeNotifyFlags.SHCNF_IDLIST"/> or
  84         /// <see cref="HChangeNotifyFlags.SHCNF_PATH"/> must be specified in <i>uFlags</i>.
  85         /// <i>dwItem1</i> contains the item or folder that has changed.
  86         /// <i>dwItem2</i> is not used and should be <see langword="null"/>.
  87         /// </summary>
  88         SHCNE_ATTRIBUTES = 0x00000800,
  89
  90         /// <summary>
  91         /// A nonfolder item has been created.
  92         /// <see cref="HChangeNotifyFlags.SHCNF_IDLIST"/> or
  93         /// <see cref="HChangeNotifyFlags.SHCNF_PATH"/> must be specified in <i>uFlags</i>.
  94         /// <i>dwItem1</i> contains the item that was created.
  95         /// <i>dwItem2</i> is not used and should be <see langword="null"/>.
  96         /// </summary>
  97         SHCNE_CREATE = 0x00000002,
  98
  99         /// <summary>
 100         /// A nonfolder item has been deleted.
 101         /// <see cref="HChangeNotifyFlags.SHCNF_IDLIST"/> or
 102         /// <see cref="HChangeNotifyFlags.SHCNF_PATH"/> must be specified in <i>uFlags</i>.
 103         /// <i>dwItem1</i> contains the item that was deleted.
 104         /// <i>dwItem2</i> is not used and should be <see langword="null"/>.
 105         /// </summary>
 106         SHCNE_DELETE = 0x00000004,
 107
 108         /// <summary>
 109         /// A drive has been added.
 110         /// <see cref="HChangeNotifyFlags.SHCNF_IDLIST"/> or
 111         /// <see cref="HChangeNotifyFlags.SHCNF_PATH"/> must be specified in <i>uFlags</i>.
 112         /// <i>dwItem1</i> contains the root of the drive that was added.
 113         /// <i>dwItem2</i> is not used and should be <see langword="null"/>.
 114         /// </summary>
 115         SHCNE_DRIVEADD = 0x00000100,
 116
 117         /// <summary>
 118         /// A drive has been added and the Shell should create a new window for the drive.
 119         /// <see cref="HChangeNotifyFlags.SHCNF_IDLIST"/> or
 120         /// <see cref="HChangeNotifyFlags.SHCNF_PATH"/> must be specified in <i>uFlags</i>.
 121         /// <i>dwItem1</i> contains the root of the drive that was added.
 122         /// <i>dwItem2</i> is not used and should be <see langword="null"/>.
 123         /// </summary>
 124         SHCNE_DRIVEADDGUI = 0x00010000,
 125
 126         /// <summary>
 127         /// A drive has been removed. <see cref="HChangeNotifyFlags.SHCNF_IDLIST"/> or
 128         /// <see cref="HChangeNotifyFlags.SHCNF_PATH"/> must be specified in <i>uFlags</i>.
 129         /// <i>dwItem1</i> contains the root of the drive that was removed.
 130         /// <i>dwItem2</i> is not used and should be <see langword="null"/>.
 131         /// </summary>
 132         SHCNE_DRIVEREMOVED = 0x00000080,
 133
 134         /// <summary>
 135         /// Not currently used.
 136         /// </summary>
 137         SHCNE_EXTENDED_EVENT = 0x04000000,
 138
 139         /// <summary>
 140         /// The amount of free space on a drive has changed.
 141         /// <see cref="HChangeNotifyFlags.SHCNF_IDLIST"/> or
 142         /// <see cref="HChangeNotifyFlags.SHCNF_PATH"/> must be specified in <i>uFlags</i>.
 143         /// <i>dwItem1</i> contains the root of the drive on which the free space changed.
 144         /// <i>dwItem2</i> is not used and should be <see langword="null"/>.
 145         /// </summary>
 146         SHCNE_FREESPACE = 0x00040000,
 147
 148         /// <summary>
 149         /// Storage media has been inserted into a drive.
 150         /// <see cref="HChangeNotifyFlags.SHCNF_IDLIST"/> or
 151         /// <see cref="HChangeNotifyFlags.SHCNF_PATH"/> must be specified in <i>uFlags</i>.
 152         /// <i>dwItem1</i> contains the root of the drive that contains the new media.
 153         /// <i>dwItem2</i> is not used and should be <see langword="null"/>.
 154         /// </summary>
 155         SHCNE_MEDIAINSERTED = 0x00000020,
 156
 157         /// <summary>
 158         /// Storage media has been removed from a drive.
 159         /// <see cref="HChangeNotifyFlags.SHCNF_IDLIST"/> or
 160         /// <see cref="HChangeNotifyFlags.SHCNF_PATH"/> must be specified in <i>uFlags</i>.
 161         /// <i>dwItem1</i> contains the root of the drive from which the media was removed.
 162         /// <i>dwItem2</i> is not used and should be <see langword="null"/>.
 163         /// </summary>
 164         SHCNE_MEDIAREMOVED = 0x00000040,
 165
 166         /// <summary>
 167         /// A folder has been created. <see cref="HChangeNotifyFlags.SHCNF_IDLIST"/>
 168         /// or <see cref="HChangeNotifyFlags.SHCNF_PATH"/> must be specified in <i>uFlags</i>.
 169         /// <i>dwItem1</i> contains the folder that was created.
 170         /// <i>dwItem2</i> is not used and should be <see langword="null"/>.
 171         /// </summary>
 172         SHCNE_MKDIR = 0x00000008,
 173
 174         /// <summary>
 175         /// A folder on the local computer is being shared via the network.
 176         /// <see cref="HChangeNotifyFlags.SHCNF_IDLIST"/> or
 177         /// <see cref="HChangeNotifyFlags.SHCNF_PATH"/> must be specified in <i>uFlags</i>.
 178         /// <i>dwItem1</i> contains the folder that is being shared.
 179         /// <i>dwItem2</i> is not used and should be <see langword="null"/>.
 180         /// </summary>
 181         SHCNE_NETSHARE = 0x00000200,
 182
 183         /// <summary>
 184         /// A folder on the local computer is no longer being shared via the network.
 185         /// <see cref="HChangeNotifyFlags.SHCNF_IDLIST"/> or
 186         /// <see cref="HChangeNotifyFlags.SHCNF_PATH"/> must be specified in <i>uFlags</i>.
 187         /// <i>dwItem1</i> contains the folder that is no longer being shared.
 188         /// <i>dwItem2</i> is not used and should be <see langword="null"/>.
 189         /// </summary>
 190         SHCNE_NETUNSHARE = 0x00000400,
 191
 192         /// <summary>
 193         /// The name of a folder has changed.
 194         /// <see cref="HChangeNotifyFlags.SHCNF_IDLIST"/> or
 195         /// <see cref="HChangeNotifyFlags.SHCNF_PATH"/> must be specified in <i>uFlags</i>.
 196         /// <i>dwItem1</i> contains the previous pointer to an item identifier list (PIDL) or name of the folder.
 197         /// <i>dwItem2</i> contains the new PIDL or name of the folder.
 198         /// </summary>
 199         SHCNE_RENAMEFOLDER = 0x00020000,
 200
 201         /// <summary>
 202         /// The name of a nonfolder item has changed.
 203         /// <see cref="HChangeNotifyFlags.SHCNF_IDLIST"/> or
 204         /// <see cref="HChangeNotifyFlags.SHCNF_PATH"/> must be specified in <i>uFlags</i>.
 205         /// <i>dwItem1</i> contains the previous PIDL or name of the item.
 206         /// <i>dwItem2</i> contains the new PIDL or name of the item.
 207         /// </summary>
 208         SHCNE_RENAMEITEM = 0x00000001,
 209
 210         /// <summary>
 211         /// A folder has been removed.
 212         /// <see cref="HChangeNotifyFlags.SHCNF_IDLIST"/> or
 213         /// <see cref="HChangeNotifyFlags.SHCNF_PATH"/> must be specified in <i>uFlags</i>.
 214         /// <i>dwItem1</i> contains the folder that was removed.
 215         /// <i>dwItem2</i> is not used and should be <see langword="null"/>.
 216         /// </summary>
 217         SHCNE_RMDIR = 0x00000010,
 218
 219         /// <summary>
 220         /// The computer has disconnected from a server.
 221         /// <see cref="HChangeNotifyFlags.SHCNF_IDLIST"/> or
 222         /// <see cref="HChangeNotifyFlags.SHCNF_PATH"/> must be specified in <i>uFlags</i>.
 223         /// <i>dwItem1</i> contains the server from which the computer was disconnected.
 224         /// <i>dwItem2</i> is not used and should be <see langword="null"/>.
 225         /// </summary>
 226         SHCNE_SERVERDISCONNECT = 0x00004000,
 227
 228         /// <summary>
 229         /// The contents of an existing folder have changed,
 230         /// but the folder still exists and has not been renamed.
 231         /// <see cref="HChangeNotifyFlags.SHCNF_IDLIST"/> or
 232         /// <see cref="HChangeNotifyFlags.SHCNF_PATH"/> must be specified in <i>uFlags</i>.
 233         /// <i>dwItem1</i> contains the folder that has changed.
 234         /// <i>dwItem2</i> is not used and should be <see langword="null"/>.
 235         /// If a folder has been created, deleted, or renamed, use SHCNE_MKDIR, SHCNE_RMDIR, or
 236         /// SHCNE_RENAMEFOLDER, respectively, instead.
 237         /// </summary>
 238         SHCNE_UPDATEDIR = 0x00001000,
 239
 240         SHCNE_UPDATEITEM = 0x00002000,
 241
 242         /// <summary>
 243         /// An image in the system image list has changed.
 244         /// <see cref="HChangeNotifyFlags.SHCNF_DWORD"/> must be specified in <i>uFlags</i>.
 245         /// </summary>
 246         SHCNE_UPDATEIMAGE = 0x00008000,
 247
 248     }
 249     #endregion // enum HChangeNotifyEventID
 250
 251     #region public enum HChangeNotifyFlags
 252     /// <summary>
 253     /// Flags that indicate the meaning of the <i>dwItem1</i> and <i>dwItem2</i> parameters.
 254     /// The uFlags parameter must be one of the following values.
 255     /// </summary>
 256     [Flags]
 257     public enum HChangeNotifyFlags
 258     {
 259         /// <summary>
 260         /// The <i>dwItem1</i> and <i>dwItem2</i> parameters are DWORD values.
 261         /// </summary>
 262         SHCNF_DWORD = 0x0003,
 263         /// <summary>
 264         /// <i>dwItem1</i> and <i>dwItem2</i> are the addresses of ITEMIDLIST structures that
 265         /// represent the item(s) affected by the change.
 266         /// Each ITEMIDLIST must be relative to the desktop folder.
 267         /// </summary>
 268         SHCNF_IDLIST = 0x0000,
 269         /// <summary>
 270         /// <i>dwItem1</i> and <i>dwItem2</i> are the addresses of null-terminated strings of
 271         /// maximum length MAX_PATH that contain the full path names
 272         /// of the items affected by the change.
 273         /// </summary>
 274         SHCNF_PATHA = 0x0001,
 275         /// <summary>
 276         /// <i>dwItem1</i> and <i>dwItem2</i> are the addresses of null-terminated strings of
 277         /// maximum length MAX_PATH that contain the full path names
 278         /// of the items affected by the change.
 279         /// </summary>
 280         SHCNF_PATHW = 0x0005,
 281         /// <summary>
 282         /// <i>dwItem1</i> and <i>dwItem2</i> are the addresses of null-terminated strings that
 283         /// represent the friendly names of the printer(s) affected by the change.
 284         /// </summary>
 285         SHCNF_PRINTERA = 0x0002,
 286         /// <summary>
 287         /// <i>dwItem1</i> and <i>dwItem2</i> are the addresses of null-terminated strings that
 288         /// represent the friendly names of the printer(s) affected by the change.
 289         /// </summary>
 290         SHCNF_PRINTERW = 0x0006,
 291         /// <summary>
 292         /// The function should not return until the notification
 293         /// has been delivered to all affected components.
 294         /// As this flag modifies other data-type flags, it cannot by used by itself.
 295         /// </summary>
 296         SHCNF_FLUSH = 0x1000,
 297         /// <summary>
 298         /// The function should begin delivering notifications to all affected components
 299         /// but should return as soon as the notification process has begun.
 300         /// As this flag modifies other data-type flags, it cannot by used by itself.
 301         /// </summary>
 302         SHCNF_FLUSHNOWAIT = 0x2000
 303     }
 304     #endregion // enum HChangeNotifyFlags
 305
 306
 307     #endregion
 308
 309
 310     internal static class NativeMethods
 311     {
 312         [DllImport("shell32.dll")]
 313         public static extern void SHChangeNotify(HChangeNotifyEventID wEventId,
 314                                            HChangeNotifyFlags uFlags,
 315                                            IntPtr dwItem1,
 316                                            IntPtr dwItem2);
 317
 318     }
 319 }