Fonction FindNextChangeNotification (fileapi.h)
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 |