Função FindNextChangeNotification (fileapi.h)
Solicita que o sistema operacional sinalize um identificador de notificação de alteração na próxima vez que detectar uma alteração apropriada.
Sintaxe
BOOL FindNextChangeNotification(
[in] HANDLE hChangeHandle
);
Parâmetros
[in] hChangeHandle
Um identificador para um identificador de notificação de alteração criado pela função FindFirstChangeNotification .
Valor retornado
Se a função for bem-sucedida, o valor retornado será diferente de zero.
Se a função falhar, o valor retornado será zero. Para obter informações de erro estendidas, chame GetLastError.
Comentários
Depois que a função FindNextChangeNotification retornar com êxito, o aplicativo poderá aguardar a notificação de que ocorreu uma alteração usando as funções de espera.
Se ocorrer uma alteração após uma chamada para FindFirstChangeNotification , mas antes de uma chamada para FindNextChangeNotification, o sistema operacional registrará a alteração. Quando FindNextChangeNotification é executado, a alteração registrada atende imediatamente a uma espera pela notificação de alteração.
Cada chamada bem-sucedida para FindNextChangeNotification deve ser seguida por uma chamada para uma das funções de espera. Se a função de espera retornar por qualquer motivo diferente do identificador de notificação de alteração que está sendo sinalizado (por exemplo, se a espera atingir o tempo limite), o aplicativo deverá repetir a espera. Não seguir essa regra pode fazer com que o sistema acabe ficando sem recursos. Isso também pode fazer com que o aplicativo perca algumas notificações de alteração.
Quando hChangeHandle não for mais necessário, feche-o usando a função FindCloseChangeNotification .
No Windows 8 e Windows Server 2012, essa função é compatível com as tecnologias a seguir.
| Tecnologia | Com suporte |
|---|---|
| Protocolo SMB (SMB) 3.0 | Sim |
| TFO (Failover transparente) do SMB 3.0 | Sim |
| SMB 3.0 com compartilhamentos de arquivos de expansão (SO) | Sim |
| Sistema de arquivos de Volume Compartilhado Clusterizado (CsvFS) | Consulte o comentário |
| ReFS (Sistema de Arquivos Resiliente) | Sim |
O aplicativo pode ter falsos positivos na pausa/retomada de CsvFs.
Exemplos
Para obter um exemplo, consulte Obtendo notificações de alteração de diretório.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows XP [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows Server 2003 [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | fileapi.h (inclua Windows.h) |
| Biblioteca | Kernel32.lib |
| DLL | Kernel32.dll |