Function Reference


_WinAPI_FindNextChangeNotification

Requests that the operating system signal a change notification handle the next time it detects an appropriate change

#include <WinAPIFiles.au3>
_WinAPI_FindNextChangeNotification ( $hChange )

Parameters

$hChange A handle to a change notification handle created by the _WinAPI_FindFirstChangeNotification() function.

Return Value

Success: True.
Failure: False, call _WinAPI_GetLastError() to get extended error information

Remarks

After the _WinAPI_FindNextChangeNotification() function returns successfully, the application can wait for notification that a change has occurred by using the _WinAPI_Wait... functions.

The _WinAPI_FindNextChangeNotification() function should not be used more than once on the same handle without using one of the wait functions.
An application may miss a change notification if it uses _WinAPI_FindNextChangeNotification() when there is a change request outstanding.

Related

_WinAPI_FindFirstChangeNotification

See Also

Search FindNextChangeNotification in MSDN Library.

Example

#include <APIFilesConstants.au3>
#include <MsgBoxConstants.au3>
#include <WinAPIFiles.au3>
#include <WinAPIProc.au3>

Opt('TrayAutoPause', 0)

Global Const $g_sPath = @TempDir & '\~TEST~'

DirCreate($g_sPath)
If Not FileExists($g_sPath) Then
        MsgBox(($MB_ICONERROR + $MB_SYSTEMMODAL), 'Error', 'Unable to create folder.')
        Exit
EndIf
ShellExecute($g_sPath) ; to ease a file creation in this folder

OnAutoItExitRegister('OnAutoItExit')

Global $g_ahObj[2]
$g_ahObj[0] = _WinAPI_FindFirstChangeNotification($g_sPath, $FILE_NOTIFY_CHANGE_FILE_NAME)
$g_ahObj[1] = _WinAPI_FindFirstChangeNotification($g_sPath, $FILE_NOTIFY_CHANGE_DIR_NAME)

If (Not $g_ahObj[0]) Or (Not $g_ahObj[1]) Then
        MsgBox(($MB_ICONERROR + $MB_SYSTEMMODAL), 'Error', 'Unable to create change notification.')
        Exit
EndIf

Local $tObjs = DllStructCreate('ptr;ptr')
Local $paObj = DllStructGetPtr($tObjs)
For $i = 0 To 1
        DllStructSetData($tObjs, $i + 1, $g_ahObj[$i])
Next

Local $iID
While 1
        Sleep(100)
        $iID = _WinAPI_WaitForMultipleObjects(2, $paObj, 0, 0)
        Switch $iID
                Case 0 ; WAIT_OBJECT_0
                        ConsoleWrite('A file was created, renamed, or deleted in the directory.' & @CRLF)
                Case 1 ; WAIT_OBJECT_0 + 1
                        ConsoleWrite('A directory was created, renamed, or deleted.' & @CRLF)
                Case Else
                        ContinueLoop
        EndSwitch
        If Not _WinAPI_FindNextChangeNotification($g_ahObj[$iID]) Then
                MsgBox(($MB_ICONERROR + $MB_SYSTEMMODAL), 'Error', 'Unexpected error.')
                Exit
        EndIf
WEnd

Func OnAutoItExit()
        For $i = 0 To 1
                If $g_ahObj[$i] Then
                        _WinAPI_FindCloseChangeNotification($g_ahObj[$i])
                EndIf
        Next
        DirRemove($g_sPath, $DIR_REMOVE)
EndFunc   ;==>OnAutoItExit