Função FindCloseChangeNotification (fileapi.h)

  • Artigo

Interrompe o monitoramento do identificador de notificação de alterações.

Sintaxe

BOOL FindCloseChangeNotification(
  [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 FindCloseChangeNotification for chamada, o identificador especificado pelo parâmetro hChangeHandle não poderá ser usado em chamadas subsequentes para a função FindNextChangeNotification ou FindCloseChangeNotification .

As notificações de alteração também podem ser usadas nas funções de espera.

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) Confira o comentário
ReFS (Sistema de Arquivos Resiliente) Sim
 

O aplicativo pode ter falsos positivos em pausa/retomada de CsvFs.

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

FindFirstChangeNotification

FindNextChangeNotification