Функция FindNextChangeNotification (fileapi.h)

  • Статья

Запрашивает, чтобы операционная система сигнализирует об изменении обработки уведомления об изменениях при следующем обнаружении соответствующего изменения.

Синтаксис

BOOL FindNextChangeNotification(
  [in] HANDLE hChangeHandle
);

Параметры

[in] hChangeHandle

Дескриптор для дескриптора уведомления об изменениях, созданного функцией FindFirstChangeNotification .

Возвращаемое значение

Если функция выполняется успешно, возвращается ненулевое значение.

Если функция выполняется неудачно, возвращается нулевое значение. Дополнительные сведения об ошибке можно получить, вызвав GetLastError.

Комментарии

После успешного возврата функции FindNextChangeNotification приложение может дождаться уведомления об изменении с помощью функций ожидания.

Если изменение происходит после вызова Метода FindFirstChangeNotification , но до вызова Метода FindNextChangeNotification, операционная система записывает это изменение. При выполнении FindNextChangeNotification записанное изменение немедленно удовлетворяет ожиданию уведомления об изменении.

За каждым успешным вызовом FindNextChangeNotification должен следовать вызов одной из функций ожидания. Если функция ожидания возвращается по какой-либо причине, кроме сигнального дескриптора уведомления об изменении (например, если время ожидания истекло), приложение должно повторить попытку ожидания. Несоблюдение этого правила может привести к тому, что в системе в конечном итоге иссякло количество ресурсов. Это также может привести к тому, что приложение пропустит некоторые уведомления об изменениях.

Если hChangeHandle больше не требуется, закройте его с помощью функции FindCloseChangeNotification .

В Windows 8 и Windows Server 2012 эта функция поддерживается следующими технологиями.

Технология Поддерживается
Протокол SMB 3.0 Да
SMB 3.0 Transparent Failover (TFO) Да
SMB 3.0 с масштабируемыми общими папками (SO) Да
Файловая система общего тома кластера (CSVFS) См. примечания
Восстанавливаемая файловая система (ReFS) Да
 

Приложение может столкнуться с ложными срабатываниями при приостановке или возобновлении работы CSVF.

Примеры

Пример см. в разделе Получение уведомлений об изменении каталога.

Требования

Требование Значение
Минимальная версия клиента Windows XP [только классические приложения]
Минимальная версия сервера Windows Server 2003 [только классические приложения]
Целевая платформа Windows
Header fileapi.h (включая Windows.h)
Библиотека Kernel32.lib
DLL Kernel32.dll

См. также

Функции управления каталогами

FindCloseChangeNotification

FindFirstChangeNotification