Export (0) Print
Expand All

FindNextChangeNotification function

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

Syntax


BOOL WINAPI FindNextChangeNotification(
  _In_  HANDLE hChangeHandle
);

Parameters

hChangeHandle [in]

A handle to a change notification handle created by the FindFirstChangeNotification function.

Return value

If the function succeeds, the return value is nonzero.

If the function fails, the return value is zero. To get extended error information, call GetLastError.

Remarks

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

If a change occurs after a call to FindFirstChangeNotification but before a call to FindNextChangeNotification, the operating system records the change. When FindNextChangeNotification is executed, the recorded change immediately satisfies a wait for the change notification.

FindNextChangeNotification 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 FindNextChangeNotification when there is a change request outstanding.

When hChangeHandle is no longer needed, close it by using the FindCloseChangeNotification function.

In Windows 8 and Windows Server 2012, this function is supported by the following technologies.

TechnologySupported

Server Message Block (SMB) 3.0 protocol

Yes

SMB 3.0 Transparent Failover (TFO)

Yes

SMB 3.0 with Scale-out File Shares (SO)

Yes

Cluster Shared Volume File System (CsvFS)

See remark

Resilient File System (ReFS)

Yes

 

Application might experience false positives on CsvFs pause/resume.

Examples

For an example, see Obtaining Directory Change Notifications.

Requirements

Minimum supported client

Windows XP [desktop apps only]

Minimum supported server

Windows Server 2003 [desktop apps only]

Header

FileAPI.h (include Windows.h);
WinBase.h on Windows Server 2008 R2, Windows 7, Windows Server 2008, Windows Vista, Windows Server 2003, and Windows XP (include Windows.h)

Library

Kernel32.lib

DLL

Kernel32.dll

See also

Directory Management Functions
FindCloseChangeNotification
FindFirstChangeNotification

 

 

Community Additions

ADD
Show:
© 2014 Microsoft