FindFirstChangeNotification

9/8/2008

Essa função cria um identificador notificação de alteração e configura as condições filtro notificação de alteração inicial. Uma espera por um identificador notificação êxito quando um compatível alteração condições de filtro ocorre na Diretório especificado ou subdiretório.

Syntax

HANDLE FindFirstChangeNotification(
  LPCTSTR lpPathName,
  BOOL bWatchSubtree,
  DWORD dwNotifyFilter
);

Parameters

• lpPathName
  [no] Ponteiro para uma seqüência de caracteres NULL-Terminated que especifica o caminho do Diretório para procurar.

• bWatchSubtree
  [no] Indica se a função monitora o Diretório ou a árvore de diretório. Se este parâmetro for definido como TRUE, os monitores função o árvore de diretório raiz no Diretório especificado. Se ele for definido para FALSE, ela monitora somente o Diretório especificado.

  Essa função falha se esse parâmetro for definido como TRUE e FILE_NOTIFY_CHANGE_CEGETINFO o sinalizador é definido.

• dwNotifyFilter
  [no] Aguardar condições de filtro que satisfaçam um notificação de alteração. A seguinte tabela mostra os valores possíveis. Este parâmetro pode ser um ou mais desses valores.

  Valor	Descrição
  FILE_NOTIFY_CHANGE_CEGETINFO	Retorna uma espera notificação de alteração para qualquer solicitação informações na Diretório observado ou subdiretório. Deve ser especificado para retornar os dados para esta função. Essa função falha se bWatchSubtree é definido como TRUE e a esse sinalizador é definido.
  FILE_NOTIFY_CHANGE_DIR_NAME	Retorna uma espera notificação de alteração para qualquer alteração Directory-Name o Diretório observado ou subdiretório. Alterações incluem criar ou excluir um Diretório.
  FILE_NOTIFY_CHANGE_FILE_NAME	Retorna uma espera notificação de alteração para qualquer alteração nome arquivo o Diretório observado ou subdiretório. As alterações incluem Renomeando, criando ou excluindo um arquivo.
  FILE_NOTIFY_CHANGE_LAST_WRITE	Retorna um notificação de alteração aguardar qualquer alteração para o último escrever tempo dos arquivos na Diretório observado ou subdiretório. O OS detecta uma alteração para o último tempo de gravação apenas quando o arquivo é gravado o disco. Para um OS que usa extensos cache, detecção ocorre somente quando o armazenar em cache é suficientemente liberado.
  FILE_NOTIFY_CHANGE_SIZE	Retorna uma espera notificação de alteração para qualquer arquivo-tamanho alteração na Diretório observado ou subdiretório. O OS detecta uma alteração no arquivo tamanho somente quando o arquivo é gravado para o disco. Para um OS que usa extensos cache, detecção ocorre somente quando o armazenar em cache é suficientemente liberado.

Return Value

Um identificador para um objeto notificação de alteração localizar indica sucesso. INVALID_HANDLE_VALUE indica falha. Para informações de erro estendidas get, chamar GetLastError.

Remarks

As funções de espera podem monitor a Diretório especificado ou subdiretório usando o identificador retornado por essa função. Um condição de espera for satisfeita quando ocorrer um dos condições de filtro no Diretório monitorado ou subdiretório. Para obter mais informações sobre as funções de espera, consulte Wait Functions.

Após o condição de espera tem sido atendidas, o aplicativo pode responder a essa condição e continuar monitoração de Diretório por chamado a função FindNextChangeNotification e o apropriado aguardar função. Quando você mais necessário o identificador, fechá-lo usando a função FindCloseChangeNotification.

Essa função falha se bWatchSubtree é definido como TRUE e FILE_NOTIFY_CHANGE_CEGETINFO o sinalizador é definido.

Requirements

Header	winbase.h
Library	coredll.lib
Windows Embedded CE	Windows CE .NET 4.0 and later
Windows Mobile	Windows Mobile Version 5.0 and later

See Also

Reference

File I/O Functions
FindCloseChangeNotification
FindNextChangeNotification

Other Resources

Wait Functions