Função FsRtlNotifyFullReportChange (ntifs.h)
A rotina FsRtlNotifyFullReportChange é concluída com a alteração pendente de notificação dos IRPs.
Sintaxe
void FsRtlNotifyFullReportChange(
[in] PNOTIFY_SYNC NotifySync,
[in] PLIST_ENTRY NotifyList,
[in] PSTRING FullTargetName,
[in] USHORT TargetNameOffset,
[in, optional] PSTRING StreamName,
[in, optional] PSTRING NormalizedParentName,
[in] ULONG FilterMatch,
[in] ULONG Action,
[in, optional] PVOID TargetContext
);
Parâmetros
[in] NotifySync
Um ponteiro para um objeto de sincronização opaco para o 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] FullTargetName
Um ponteiro para uma cadeia de caracteres ANSI ou Unicode que contém o nome de caminho completo do arquivo.
[in] TargetNameOffset
Deslocamento dentro da cadeia de caracteres FullTargetName do componente final do nome.
[in, optional] StreamName
Ponteiro opcional para uma cadeia de caracteres ANSI ou Unicode que contém um nome de fluxo a ser armazenado com o nome do arquivo.
[in, optional] NormalizedParentName
Ponteiro opcional para uma cadeia de caracteres ANSI ou Unicode que contém o mesmo caminho que na cadeia de caracteres FullTargetName , mas com todos os nomes curtos substituídos pelos nomes longos correspondentes.
[in] FilterMatch
Uma máscara de bits de sinalizadores a ser comparada com o filtro de conclusão na estrutura de notificação. Se qualquer um dos bits correspondentes no filtro de conclusão estiver definido, uma condição de notificação existirá. Para obter valores de sinalizador possíveis, consulte o parâmetro CompletionFilter de FsRtlNotifyFullChangeDirectory.
[in] Action
Especifica o código de ação a ser armazenado no buffer do usuário, se presente. O código de ação pode ser um dos valores descritos a seguir.
| Código de ação | Significado |
|---|---|
| FILE_ACTION_ADDED | Um novo arquivo ou subdiretório foi criado. |
| FILE_ACTION_REMOVED | Um arquivo ou subdiretório foi excluído. |
| FILE_ACTION_MODIFIED | Um arquivo ou subdiretório foi modificado (mas não foi criado ou excluído). |
| FILE_ACTION_RENAMED_OLD_NAME | Esse é o nome antigo de um arquivo que foi renomeado. |
| FILE_ACTION_RENAMED_NEW_NAME | Esse é o novo nome de um arquivo que foi renomeado. |
| FILE_ACTION_ADDED_STREAM | Um novo fluxo foi aberto. |
| FILE_ACTION_REMOVED_STREAM | Um fluxo foi fechado. |
| FILE_ACTION_MODIFIED_STREAM | Um fluxo foi modificado (mas não aberto ou fechado). |
| FILE_ACTION_REMOVED_BY_DELETE | Uma ID de objeto foi removida do índice por uma operação de exclusão de arquivo. |
| FILE_ACTION_ID_NOT_TUNNELLED | Uma ID de objeto para um arquivo não pôde ser encapsulada porque sua ID de objeto correspondia à ID de um arquivo já existente. |
| FILE_ACTION_TUNNELLED_ID_COLLISION | Uma ID de objeto para um arquivo não pôde ser encapsulada porque o arquivo já tem uma ID de objeto. |
[in, optional] TargetContext
Ponteiro de contexto para passar para o sistema de arquivos se executar uma passagem marcar no caso de uma árvore sendo observada. Para obter mais informações, consulte o parâmetro TraverseCallback de FsRtlNotifyFullChangeDirectory.
Retornar valor
Nenhum
Comentários
FsRtlNotifyFullReportChange é chamado por um sistema de arquivos quando um arquivo é modificado para que a alteração pendente de notificação IRPs possa ser concluída.
FsRtlNotifyFullReportChange procura uma estrutura de notificação na lista de notificação que corresponda ao filtro e ao nome do caminho especificados. Se uma correspondência for encontrada, FsRtlNotifyFullReportChange concluirá todos os IRPs pendentes para a estrutura de notificação.
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 de DDI | HwStorPortProhibitedDIs(storport), PowerIrpDDis(wdm) |