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

Siehe auch

Verzeichnisverwaltungsfunktionen

FindCloseChangeNotification

FindFirstChangeNotification