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 |