Fonction FindNextChangeNotification (fileapi.h)

  • Article

Demande que le système d’exploitation signale un handle de notification de modification la prochaine fois qu’il détecte une modification appropriée.

Syntaxe

BOOL FindNextChangeNotification(
  [in] HANDLE hChangeHandle
);

Paramètres

[in] hChangeHandle

Handle vers un handle de notification de modification créé par la fonction FindFirstChangeNotification .

Valeur retournée

Si la fonction réussit, la valeur de retour est différente de zéro.

Si la fonction échoue, la valeur de retour est égale à zéro. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.

Remarques

Une fois la fonction FindNextChangeNotification retournée avec succès, l’application peut attendre la notification indiquant qu’une modification s’est produite à l’aide des fonctions d’attente.

Si une modification se produit après un appel à FindFirstChangeNotification , mais avant un appel à FindNextChangeNotification, le système d’exploitation enregistre la modification. Lorsque FindNextChangeNotification est exécuté, la modification enregistrée répond immédiatement à une attente de la notification de modification.

Chaque appel réussi à FindNextChangeNotification doit être suivi d’un appel à l’une des fonctions d’attente. Si la fonction d’attente retourne pour une raison autre que le handle de notification de modification signalé (par exemple, si l’attente expire), l’application doit réessayer l’attente. Si vous ne suivez pas cette règle, le système finit par manquer de ressources. Cela peut également entraîner l’absence de notifications de modification de l’application.

Lorsque hChangeHandle n’est plus nécessaire, fermez-le à l’aide de la fonction FindCloseChangeNotification .

Dans Windows 8 et Windows Server 2012, cette fonction est prise en charge par les technologies suivantes.

Technologie Prise en charge
Protocole Server Message Block (SMB) 3.0 Oui
Basculement transparent SMB 3.0 (TFO) Oui
SMB 3.0 avec partages de fichiers avec montée en puissance parallèle (SO) Oui
Système de fichiers du volume partagé de cluster (CsvFS) Voir la remarque
Système de fichiers résilient (ReFS) Oui
 

L’application peut rencontrer des faux positifs sur la pause/reprise csvFs.

Exemples

Pour obtenir un exemple, consultez Obtention de notifications de modification d’annuaire.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2003 [applications de bureau uniquement]
Plateforme cible Windows
En-tête fileapi.h (inclure Windows.h)
Bibliothèque Kernel32.lib
DLL Kernel32.dll

Voir aussi

Fonctions de gestion des répertoires

FindCloseChangeNotification

FindFirstChangeNotification