Funzione FindNextChangeNotification (fileapi.h)
Richiede che il sistema operativo segnali un handle di notifica delle modifiche al successivo rilevamento di una modifica appropriata.
Sintassi
BOOL FindNextChangeNotification(
[in] HANDLE hChangeHandle
);
Parametri
[in] hChangeHandle
Handle per un handle di notifica delle modifiche creato dalla funzione FindFirstChangeNotification .
Valore restituito
Se la funzione ha esito positivo, il valore restituito è diverso da zero.
Se la funzione ha esito negativo, il valore restituito è zero. Per informazioni dettagliate sull'errore, chiamare GetLastError.
Commenti
Dopo che la funzione FindNextChangeNotification restituisce correttamente, l'applicazione può attendere la notifica che si è verificata una modifica usando le funzioni di attesa.
Se si verifica una modifica dopo una chiamata a FindFirstChangeNotification , ma prima di una chiamata a FindNextChangeNotification, il sistema operativo registra la modifica. Quando FindNextChangeNotification viene eseguito, la modifica registrata soddisfa immediatamente un'attesa per la notifica delle modifiche.
Ogni chiamata riuscita a FindNextChangeNotification deve essere seguita da una chiamata a una delle funzioni di attesa. Se la funzione di attesa restituisce per qualsiasi motivo diverso dall'handle di notifica delle modifiche segnalato (ad esempio, se il timeout di attesa), l'applicazione deve ripetere l'attesa. Se non si esegue questa regola, il sistema non riesce a uscire dalle risorse. Può anche causare la mancanza di alcune notifiche di modifica dell'applicazione.
Quando hChangeHandle non è più necessario, chiuderlo usando la funzione FindCloseChangeNotification .
In Windows 8 e Windows Server 2012 questa funzione è supportata dalle tecnologie seguenti.
Tecnologia | Supportato |
---|---|
Protocollo SMB (Server Message Block) 3.0 | Sì |
Failover trasparente SMB 3.0 (TFO) | Sì |
SMB 3.0 con condivisioni file con scalabilità orizzontale (SO) | Sì |
File system del volume condiviso del cluster (CsvFS) | Vedere l'osservazione |
File system resiliente (ReFS) | Sì |
L'applicazione potrebbe riscontrare falsi positivi in csvFs pausa/ripresa.
Esempio
Per un esempio, vedere Ottenere notifiche di modifica directory.
Requisiti
Requisito | Valore |
---|---|
Client minimo supportato | Windows XP [solo app desktop] |
Server minimo supportato | Windows Server 2003 [solo app desktop] |
Piattaforma di destinazione | Windows |
Intestazione | fileapi.h (includere Windows.h) |
Libreria | Kernel32.lib |
DLL | Kernel32.dll |