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.

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

Ejemplos

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

Requisitos

Vea también

Funciones de administración de directorios

FindCloseChangeNotification

FindFirstChangeNotification