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

Vedere anche

Funzioni di gestione delle directory

FindCloseChangeNotification

FindFirstChangeNotification