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

Confira também

Funções do gerenciamento de diretórios

FindCloseChangeNotification

FindFirstChangeNotification