FindCloseChangeNotification function (fileapi.h)

Article
02/22/2024

Stops change notification handle monitoring.

Syntax

BOOL FindCloseChangeNotification(
  [in] HANDLE hChangeHandle
);

Parameters

[in] hChangeHandle

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 FindCloseChangeNotification function is called, the handle specified by the hChangeHandle parameter cannot be used in subsequent calls to either the FindNextChangeNotification or FindCloseChangeNotification function.

Change notifications can also be used in the wait functions.

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

Technology	Supported
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.

Requirements

Requirement	Value
Minimum supported client	Windows XP [desktop apps only]
Minimum supported server	Windows Server 2003 [desktop apps only]
Target Platform	Windows
Header	fileapi.h (include Windows.h)
Library	Kernel32.lib
DLL	Kernel32.dll