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.

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

Confira também

Funções do gerenciamento de diretórios

FindCloseChangeNotification

FindFirstChangeNotification