win32file.ReadDirectoryChangesW
ReadDirectoryChangesW(handle, size, bWatchSubtree, dwNotifyFilter, overlapped)
retrieves information describing the changes occurring within a directory.
Parameters
handle : PyHANDLE
Handle to the directory to be monitored. This directory must be opened with the FILE_LIST_DIRECTORY access right.size : int
Size of the buffer to allocate for the results.bWatchSubtree : int
Specifies whether the ReadDirectoryChangesW function will monitor the directory or the directory tree. If TRUE is specified, the function monitors the directory tree rooted at the specified directory. If FALSE is specified, the function monitors only the directory specified by the hDirectory parameter.dwNotifyFilter : int
Specifies filter criteria the function checks to determine if the wait operation has completed. This parameter can be one or more of the FILE_NOTIFY_CHANGE_* values.overlapped=None : PyOVERLAPPED
An overlapped object. The directory must also be opened with FILE_FLAG_OVERLAPPED.
Comments
If you pass an overlapped object, you almost certainly
must pass a buffer object for the asynchronous results - failure
to do so may crash Python as the asynchronous result writes to
invalid memory.
The FILE_NOTIFY_INFORMATION structure used by this function
is variable length, depending on the length of the filename.
The size of the buffer must be at least 6 bytes long + the length
of the filenames returned. The number of notifications that can be
returned for a given buffer size depends on the filename lengths.
Return Value
If a buffer size is passed, the result is a list of (action, filename)
If a buffer is passed, the result is None - you must use the overlapped
object to determine when the information is available and how much is valid.
The buffer can then be passed to win32file::FILE_NOTIFY_INFORMATION