Função FsRtlNotifyFullChangeDirectory (ntifs.h)
A rotina
Sintaxe
void FsRtlNotifyFullChangeDirectory(
[in] PNOTIFY_SYNC NotifySync,
[in] PLIST_ENTRY NotifyList,
[in] PVOID FsContext,
[in] PSTRING FullDirectoryName,
[in] BOOLEAN WatchTree,
[in] BOOLEAN IgnoreBuffer,
[in] ULONG CompletionFilter,
[in, optional] PIRP NotifyIrp,
[in, optional] PCHECK_FOR_TRAVERSE_ACCESS TraverseCallback,
[in, optional] PSECURITY_SUBJECT_CONTEXT SubjectContext
);
Parâmetros
[in] NotifySync
Um ponteiro para um objeto de sincronização opaco para a lista de notificação do volume atual.
[in] NotifyList
Um ponteiro para o cabeçalho de uma lista de notificação. Cada elemento na lista é uma estrutura de notificação opaca.
[in] FsContext
Um ponteiro para um valor exclusivo atribuído pelo sistema de arquivos para identificar a estrutura de notificação a ser criada como pertencente a um objeto de arquivo específico. Se uma rotina
[in] FullDirectoryName
Um ponteiro para uma cadeia de caracteres ANSI ou Unicode que contém o nome completo do diretório associado a essa estrutura de notificação. Ignorado se NotifyIrp for NULL.
[in] WatchTree
Defina como TRUE se todos os subdiretórios desse diretório também devem ser observados. Defina como FALSE se apenas o próprio diretório for observado. Ignorado se NotifyIrp for NULL.
[in] IgnoreBuffer
Defina como TRUE para ignorar os buffers de usuário e forçar o diretório a ser reenumerado. Essa ação acelera a operação. Ignorado se NotifyIrp for NULL.
[in] CompletionFilter
Máscara de bits de sinalizadores que especificam os tipos de alterações em arquivos ou subdiretórios que devem fazer com que a fila de IRPs de notificação pendente seja concluída. A tabela a seguir descreve os possíveis valores de sinalizador.
| Bandeira | Significado |
|---|---|
| FILE_NOTIFY_CHANGE_FILE_NAME (0x0001) | Um arquivo foi adicionado, excluído ou renomeado neste diretório. |
| FILE_NOTIFY_CHANGE_DIR_NAME (0x0002) | Um subdiretório foi criado, removido ou renomeado. |
| FILE_NOTIFY_CHANGE_NAME (0x0003) | O nome desse diretório foi alterado. |
| FILE_NOTIFY_CHANGE_ATTRIBUTES (0x0004) | O valor de um atributo desse arquivo, como a hora do último acesso, foi alterado. |
| FILE_NOTIFY_CHANGE_SIZE (0x0008) | O tamanho desse arquivo foi alterado. |
| FILE_NOTIFY_CHANGE_LAST_WRITE (0x0010) | A hora da última modificação desse arquivo foi alterada. |
| FILE_NOTIFY_CHANGE_LAST_ACCESS (0x0020) | A hora de acesso do último arquivo foi alterada. |
| FILE_NOTIFY_CHANGE_CREATION (0x0040) | O tempo de criação desse arquivo foi alterado. |
| FILE_NOTIFY_CHANGE_EA (0x0080) | Os atributos estendidos desse arquivo foram modificados. |
| FILE_NOTIFY_CHANGE_SECURITY (0x0100) | As informações de segurança desse arquivo foram alteradas. |
| FILE_NOTIFY_CHANGE_STREAM_NAME (0x0200) | Um fluxo de arquivos foi adicionado, excluído ou renomeado neste diretório. |
| FILE_NOTIFY_CHANGE_STREAM_SIZE (0x0400) | O tamanho desse fluxo de arquivos foi alterado. |
| FILE_NOTIFY_CHANGE_STREAM_WRITE (0x0800) | Os dados desse fluxo de arquivos foram alterados. |
CompletionFilter será ignorado se NotifyIrp for NULL.
[in, optional] NotifyIrp
Um ponteiro para o IRP a ser concluído na alteração de notificação. Se NotifyIrp for NULL, isso significa que o fluxo de arquivos representado por esse objeto de arquivo está sendo excluído.
[in, optional] TraverseCallback
Ponteiro opcional para uma rotina de retorno de chamada a ser invocada quando ocorre uma alteração em um subdiretório sendo observado em uma árvore de diretório. Isso permite que o sistema de arquivos verifique se o observador atravessou o acesso a esse diretório. Essa rotina fornecida pelo chamador é declarada da seguinte maneira:
NTSTATUS
(*PCHECK_FOR_TRAVERSE_ACCESS) (
IN PVOID NotifyContext, // FsContext
IN PVOID TargetContext, // Context pointer
IN PSECURITY_SUBJECT_CONTEXT SubjectContext // SubjectContext
);
Para obter mais informações sobre o parâmetro TargetContext, consulte o parâmetro TargetContext de FsRtlNotifyFullReportChange. TraverseCallback será ignorado se NotifyIrp for NULL.
[in, optional] SubjectContext
Um ponteiro para uma estrutura de SECURITY_SUBJECT_CONTEXT a ser passada para TraverseCallback .
FsRtlNotifyFullChangeDirectory libera o contexto e libera a estrutura depois de usá-la. Ignorado se NotifyIrp for NULL. Se uma rotina TraverseCallback
Valor de retorno
Nenhum
Observações
FsRtlNotifyFullChangeDirectory é chamado por um sistema de arquivos que recebeu uma solicitação de alteração de notificação. Essa solicitação é recebida como um IRP com IRP_MJ_DIRECTORY_CONTROL de código de função principal, IRP_MN_NOTIFY_CHANGE_DIRECTORY de código de função secundária.
Se NotifyIrp for NULL, FsRtlNotifyFullChangeDirectory verificará se a lista de notificação contém um IRP pendente que se refere a esse objeto de arquivo e, em caso afirmativo, conclui-o com STATUS_DELETE_PENDING.
Se NotifyIrp não for NULL, FsRtlNotifyFullChangeDirectory fará o seguinte:
Verifica se o objeto de arquivo passou por limpeza. Nesse caso, FsRtlNotifyFullChangeDirectory conclui o IRP de notificação com STATUS_NOTIFY_CLEANUP de status.
Se o objeto de arquivo não tiver passado por limpeza, FsRtlNotifyFullChangeDirectory verificar se a lista de notificação desse volume já contém uma estrutura de notificação para essa alteração. Nesse caso, FsRtlNotifyFullChangeDirectory concluirá todos os IRPs pendentes. Caso contrário, FsRtlNotifyFullChangeDirectory marca o IRP de notificação como pendente, cria uma estrutura de notificação e a insere na lista.
Requisitos
| Requisito | Valor |
|---|---|
| da Plataforma de Destino |
Universal |
| cabeçalho | ntifs.h (inclua Ntifs.h) |
| biblioteca | NtosKrnl.lib |
| de DLL |
NtosKrnl.exe |
| IRQL | PASSIVE_LEVEL |
| regras de conformidade de DDI | HwStorPortProhibitedDIs(storport), PowerIrpDDis(wdm) |