FindNextChangeNotification-Funktion (fileapi.h)
Hiermit wird das Betriebssystem aufgefordert, einem Änderungsbenachrichtigungshandle zu signalisieren, wenn das nächste Mal eine entsprechende Änderung erkannt wird.
Syntax
BOOL FindNextChangeNotification(
[in] HANDLE hChangeHandle
);
Parameter
[in] hChangeHandle
Ein Handle für ein Änderungsbenachrichtigungshandle, das von der FindFirstChangeNotification-Funktion erstellt wurde.
Rückgabewert
Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.
Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.
Hinweise
Nachdem die FindNextChangeNotification-Funktion erfolgreich zurückgegeben wurde, kann die Anwendung mithilfe der Wait-Funktionen auf eine Benachrichtigung warten, dass eine Änderung erfolgt ist.
Wenn eine Änderung nach einem Aufruf von FindFirstChangeNotification , aber vor einem Aufruf von FindNextChangeNotification auftritt, zeichnet das Betriebssystem die Änderung auf. Wenn FindNextChangeNotification ausgeführt wird, erfüllt die aufgezeichnete Änderung sofort eine Wartezeit auf die Änderungsbenachrichtigung.
Jedem erfolgreichen Aufruf von FindNextChangeNotification muss ein Aufruf einer der Wartefunktionen folgen. Wenn die Wait-Funktion aus einem anderen Grund als dem signalisierenden Änderungsbenachrichtigungshandle zurückgibt (z. B. bei einem Zeitüberschreitungsüberschreitung des Wartevorgangs), muss die Anwendung den Wartevorgang wiederholen. Wenn Sie diese Regel nicht befolgen, kann dies dazu führen, dass dem System schließlich die Ressourcen ausgehen. Dies kann auch dazu führen, dass die Anwendung einige Änderungsbenachrichtigungen verpasst.
Wenn hChangeHandle nicht mehr benötigt wird, schließen Sie es mithilfe der Funktion FindCloseChangeNotification .
Unter Windows 8 und Windows Server 2012 wird diese Funktion von den folgenden Technologien unterstützt.
| Technologie | Unterstützt |
|---|---|
| SMB 3.0-Protokoll (Server Message Block) | Ja |
| SMB 3.0 Transparent Failover (TFO) | Ja |
| SMB 3.0 mit Dateifreigaben mit horizontaler Skalierung (SO) | Ja |
| Dateisystem mit freigegebenen Clustervolumes (CsvFS) | Siehe Bemerkung |
| Robustes Dateisystem (Resilient File System, ReFS) | Ja |
Bei der Anwendung treten möglicherweise falsch positive Ergebnisse für csvFs pause/resume auf.
Beispiele
Ein Beispiel finden Sie unter Abrufen von Verzeichnisänderungsbenachrichtigungen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows XP [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2003 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | fileapi.h (Einschließen von Windows.h) |
| Bibliothek | Kernel32.lib |
| DLL | Kernel32.dll |