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