Función FindNextChangeNotification (fileapi.h)

Solicita que el sistema operativo indique un identificador de notificación de cambio la próxima vez que detecte un cambio adecuado.

Sintaxis

BOOL FindNextChangeNotification(
  [in] HANDLE hChangeHandle
);

Parámetros

[in] hChangeHandle

Identificador de un identificador de notificación de cambio creado por la función FindFirstChangeNotification .

Valor devuelto

Si la función se realiza correctamente, el valor devuelto es distinto de cero.

Si la función no se realiza correctamente, el valor devuelto es cero. Para obtener información de error extendida, llame a GetLastError.

Comentarios

Después de que la función FindNextChangeNotification se devuelva correctamente, la aplicación puede esperar una notificación de que se ha producido un cambio mediante las funciones de espera.

Si se produce un cambio después de una llamada a FindFirstChangeNotification pero antes de una llamada a FindNextChangeNotification, el sistema operativo registra el cambio. Cuando se ejecuta FindNextChangeNotification , el cambio registrado satisface inmediatamente una espera para la notificación de cambio.

Cada llamada correcta a FindNextChangeNotification debe ir seguida de una llamada a una de las funciones de espera. Si la función wait devuelve por cualquier motivo distinto del identificador de notificación de cambio que se señala (por ejemplo, si se agota el tiempo de espera), la aplicación debe reintentar la espera. Si no se sigue esta regla, el sistema se quedará sin recursos. También puede hacer que la aplicación pierda algunas notificaciones de cambio.

Cuando ya no se necesite hChangeHandle , ciérrelo mediante la función FindCloseChangeNotification .

En Windows 8 y Windows Server 2012, esta función es compatible con las tecnologías siguientes.

Tecnología	Compatible
Protocolo Bloque de mensajes del servidor (SMB) 3.0	Sí
Conmutación por error transparente (TFO) de SMB 3.0	Sí
SMB 3.0 con recursos compartidos de archivos de escalabilidad horizontal (SO)	Sí
Sistema de archivos de Volumen compartido de clúster (CsvFS)	Ver comentarios
Sistema de archivos resistente a errores (ReFS)	Sí

 

La aplicación puede experimentar falsos positivos en csvFs pause/resume.

Ejemplos

Para obtener un ejemplo, vea Obtener notificaciones de cambio de directorio.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	fileapi.h (incluya Windows.h)
Library	Kernel32.lib
Archivo DLL	Kernel32.dll

Vea también

Funciones de administración de directorios

FindCloseChangeNotification

FindFirstChangeNotification