Função FsRtlNotifyFullChangeDirectory (ntifs.h)

  • Artigo

A rotina FsRtlNotifyFullChangeDirectory cria uma estrutura de notificação para uma solicitação de notificação e a adiciona à lista de notificação especificada.

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 TraverseCallback for fornecida, FsContext será passado como o parâmetro NotifyContext para essa 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 deve ser 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.

Sinalizador 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 do último acesso desse 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 ao notificar a alteraçã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 marcar se o observador tem acesso ao 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 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 for fornecida, SubjectContext será passado como o parâmetro SubjectContext para essa rotina.

Retornar valor

Nenhum

Comentários

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, se for o caso, o concluirá 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 a notificação do IRP com status STATUS_NOTIFY_CLEANUP.

  • Se o objeto de arquivo não tiver passado por limpeza, FsRtlNotifyFullChangeDirectory verificará se a lista de notificação para esse volume já contém uma estrutura de notificação para essa alteração. Nesse caso, FsRtlNotifyFullChangeDirectory conclui 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
Plataforma de Destino Universal
Cabeçalho ntifs.h (inclua Ntifs.h)
Biblioteca NtosKrnl.lib
DLL NtosKrnl.exe
IRQL PASSIVE_LEVEL
Regras de conformidade da DDI HwStorPortProhibitedDDIs(storport), PowerIrpDDis(wdm)

Confira também

FsRtlNotifyFullReportChange

IRP_MJ_DIRECTORY_CONTROL

SECURITY_SUBJECT_CONTEXT