dlls/kernel32/change.c

   1 /*
   2  * Win32 file change notification functions
   3  *
   4  * Copyright 1998 Ulrich Weigand
   5  *
   6  * This library is free software; you can redistribute it and/or
   7  * modify it under the terms of the GNU Lesser General Public
   8  * License as published by the Free Software Foundation; either
   9  * version 2.1 of the License, or (at your option) any later version.
  10  *
  11  * This library is distributed in the hope that it will be useful,
  12  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  13  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  14  * Lesser General Public License for more details.
  15  *
  16  * You should have received a copy of the GNU Lesser General Public
  17  * License along with this library; if not, write to the Free Software
  18  * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA
  19  */
  20
  21 #include "config.h"
  22
  23 #include <stdarg.h>
  24 #include <stdlib.h>
  25 #include <string.h>
  26
  27 #include "ntstatus.h"
  28 #define WIN32_NO_STATUS
  29 #define NONAMELESSUNION
  30 #define NONAMELESSSTRUCT
  31 #include "windef.h"
  32 #include "winbase.h"
  33 #include "winerror.h"
  34 #include "winternl.h"
  35 #include "kernel_private.h"
  36 #include "wine/debug.h"
  37
  38 WINE_DEFAULT_DEBUG_CHANNEL(file);
  39
  40 /****************************************************************************
  41  *              FindFirstChangeNotificationA (KERNEL32.@)
  42  */
  43 HANDLE WINAPI FindFirstChangeNotificationA( LPCSTR lpPathName, BOOL bWatchSubtree,
  44                                             DWORD dwNotifyFilter )
  45 {
  46     WCHAR *pathW;
  47
  48     if (!(pathW = FILE_name_AtoW( lpPathName, FALSE ))) return INVALID_HANDLE_VALUE;
  49     return FindFirstChangeNotificationW( pathW, bWatchSubtree, dwNotifyFilter );
  50 }
  51
  52 /*
  53  * NtNotifyChangeDirectoryFile may write back to the IO_STATUS_BLOCK
  54  * asynchronously.  We don't care about the contents, but it can't
  55  * be placed on the stack since it will go out of scope when we return.
  56  */
  57 static IO_STATUS_BLOCK FindFirstChange_iosb;
  58
  59 /****************************************************************************
  60  *              FindFirstChangeNotificationW (KERNEL32.@)
  61  */
  62 HANDLE WINAPI FindFirstChangeNotificationW( LPCWSTR lpPathName, BOOL bWatchSubtree,
  63                                             DWORD dwNotifyFilter)
  64 {
  65     UNICODE_STRING nt_name;
  66     OBJECT_ATTRIBUTES attr;
  67     NTSTATUS status;
  68     HANDLE handle = INVALID_HANDLE_VALUE;
  69
  70     TRACE( "%s %d %x\n", debugstr_w(lpPathName), bWatchSubtree, dwNotifyFilter );
  71
  72     if (!RtlDosPathNameToNtPathName_U( lpPathName, &nt_name, NULL, NULL ))
  73     {
  74         SetLastError( ERROR_PATH_NOT_FOUND );
  75         return handle;
  76     }
  77
  78     attr.Length = sizeof(attr);
  79     attr.RootDirectory = 0;
  80     attr.Attributes = OBJ_CASE_INSENSITIVE;
  81     attr.ObjectName = &nt_name;
  82     attr.SecurityDescriptor = NULL;
  83     attr.SecurityQualityOfService = NULL;
  84
  85     status = NtOpenFile( &handle, FILE_LIST_DIRECTORY | SYNCHRONIZE,
  86                          &attr, &FindFirstChange_iosb,
  87                          FILE_SHARE_READ | FILE_SHARE_WRITE | FILE_SHARE_DELETE,
  88                          FILE_DIRECTORY_FILE | FILE_SYNCHRONOUS_IO_NONALERT );
  89     RtlFreeUnicodeString( &nt_name );
  90
  91     if (status != STATUS_SUCCESS)
  92     {
  93         SetLastError( RtlNtStatusToDosError(status) );
  94         return INVALID_HANDLE_VALUE;
  95     }
  96
  97     status = NtNotifyChangeDirectoryFile( handle, NULL, NULL, NULL,
  98                                           &FindFirstChange_iosb,
  99                                           NULL, 0, dwNotifyFilter, bWatchSubtree );
 100     if (status != STATUS_PENDING)
 101     {
 102         NtClose( handle );
 103         SetLastError( RtlNtStatusToDosError(status) );
 104         return INVALID_HANDLE_VALUE;
 105     }
 106     return handle;
 107 }
 108
 109 /****************************************************************************
 110  *              FindNextChangeNotification (KERNEL32.@)
 111  */
 112 BOOL WINAPI FindNextChangeNotification( HANDLE handle )
 113 {
 114     NTSTATUS status;
 115
 116     TRACE("%p\n",handle);
 117
 118     status = NtNotifyChangeDirectoryFile( handle, NULL, NULL, NULL,
 119                                           &FindFirstChange_iosb,
 120                                           NULL, 0, FILE_NOTIFY_CHANGE_SIZE, 0 );
 121     if (status != STATUS_PENDING)
 122     {
 123         SetLastError( RtlNtStatusToDosError(status) );
 124         return FALSE;
 125     }
 126     return TRUE;
 127 }
 128
 129 /****************************************************************************
 130  *              FindCloseChangeNotification (KERNEL32.@)
 131  */
 132 BOOL WINAPI FindCloseChangeNotification( HANDLE handle )
 133 {
 134     return CloseHandle( handle );
 135 }
 136
 137 /****************************************************************************
 138  *              ReadDirectoryChangesW (KERNEL32.@)
 139  *
 140  * NOTES
 141  *
 142  *  The filter is remember from the first run and ignored on successive runs.
 143  *
 144  *  If there's no output buffer on the first run, it's ignored successive runs
 145  *   and STATUS_NOTIFY_ENUM_DIRECTORY is returned with an empty buffer.
 146  *
 147  *  If a NULL overlapped->hEvent is passed, the directory handle is used
 148  *   for signalling.
 149  */
 150 BOOL WINAPI ReadDirectoryChangesW( HANDLE handle, LPVOID buffer, DWORD len, BOOL subtree,
 151                                    DWORD filter, LPDWORD returned, LPOVERLAPPED overlapped,
 152                                    LPOVERLAPPED_COMPLETION_ROUTINE completion )
 153 {
 154     OVERLAPPED ov, *pov;
 155     IO_STATUS_BLOCK *ios;
 156     NTSTATUS status;
 157     BOOL ret = TRUE;
 158     LPVOID cvalue = NULL;
 159
 160     TRACE("%p %p %08x %d %08x %p %p %p\n", handle, buffer, len, subtree, filter,
 161            returned, overlapped, completion );
 162
 163     if (!overlapped)
 164     {
 165         memset( &ov, 0, sizeof ov );
 166         ov.hEvent = CreateEventW( NULL, 0, 0, NULL );
 167         pov = &ov;
 168     }
 169     else
 170     {
 171         pov = overlapped;
 172         if (!completion && ((ULONG_PTR)overlapped->hEvent & 1) == 0) cvalue = overlapped;
 173     }
 174
 175     ios = (PIO_STATUS_BLOCK) pov;
 176     ios->u.Status = STATUS_PENDING;
 177
 178     status = NtNotifyChangeDirectoryFile( handle, pov->hEvent, NULL, cvalue,
 179                                           ios, buffer, len, filter, subtree );
 180     if (status == STATUS_PENDING)
 181     {
 182         if (overlapped)
 183             return TRUE;
 184
 185         WaitForSingleObjectEx( ov.hEvent, INFINITE, TRUE );
 186         CloseHandle( ov.hEvent );
 187         if (returned)
 188             *returned = ios->Information;
 189         status = ios->u.Status;
 190     }
 191
 192     if (status != STATUS_SUCCESS)
 193     {
 194         SetLastError( RtlNtStatusToDosError(status) );
 195         ret = FALSE;
 196     }
 197
 198     return ret;
 199 }