FsRtlNotifyFullReportChange, fonction (ntifs.h)
La routine FsRtlNotifyFullReportChange termine les irps de modification de notification en attente.
Syntaxe
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
);
Paramètres
[in] NotifySync
Pointeur vers un objet de synchronisation opaque pour le volume actuel.
[in] NotifyList
Pointeur vers la tête d’une liste de notifications. Chaque élément de la liste est une structure de notification opaque.
[in] FullTargetName
Pointeur vers une chaîne ANSI ou Unicode qui contient le chemin d’accès complet du fichier.
[in] TargetNameOffset
Décalage dans la chaîne FullTargetName du composant final du nom.
[in, optional] StreamName
Pointeur facultatif vers une chaîne ANSI ou Unicode qui contient un nom de flux à stocker avec le nom de fichier.
[in, optional] NormalizedParentName
Pointeur facultatif vers une chaîne ANSI ou Unicode qui contient le même chemin que dans la chaîne FullTargetName , mais avec tous les noms courts remplacés par les noms longs correspondants.
[in] FilterMatch
Masque de bits d’indicateurs à comparer au filtre d’achèvement dans la structure de notification. Si l’un des bits correspondants dans le filtre d’achèvement est défini, une condition de notification existe. Pour connaître les valeurs d’indicateur possibles, consultez le paramètre CompletionFilter de FsRtlNotifyFullChangeDirectory.
[in] Action
Spécifie le code d’action à stocker dans la mémoire tampon de l’utilisateur, le cas échéant. Le code d’action peut être l’une des valeurs décrites ci-dessous.
| Code d’action | Signification |
|---|---|
| FILE_ACTION_ADDED | Un nouveau fichier ou un sous-répertoire a été créé. |
| FILE_ACTION_REMOVED | Un fichier ou un sous-répertoire a été supprimé. |
| FILE_ACTION_MODIFIED | Un fichier ou un sous-répertoire a été modifié (mais pas créé ou supprimé). |
| FILE_ACTION_RENAMED_OLD_NAME | Il s’agit de l’ancien nom d’un fichier qui a été renommé. |
| FILE_ACTION_RENAMED_NEW_NAME | Il s’agit du nouveau nom d’un fichier qui a été renommé. |
| FILE_ACTION_ADDED_STREAM | Un nouveau flux a été ouvert. |
| FILE_ACTION_REMOVED_STREAM | Un flux a été fermé. |
| FILE_ACTION_MODIFIED_STREAM | Un flux a été modifié (mais pas ouvert ou fermé). |
| FILE_ACTION_REMOVED_BY_DELETE | Un ID d’objet a été supprimé de l’index par une opération de suppression de fichier. |
| FILE_ACTION_ID_NOT_TUNNELLED | Impossible de tunneliser un ID d’objet pour un fichier, car son ID d’objet correspondait à l’ID d’un fichier déjà existant. |
| FILE_ACTION_TUNNELLED_ID_COLLISION | Impossible de tunneliser un ID d’objet pour un fichier, car le fichier a déjà un ID d’objet. |
[in, optional] TargetContext
Pointeur de contexte à passer au système de fichiers si vous effectuez une traversée case activée dans le cas d’une arborescence surveillée. Pour plus d’informations, consultez le paramètre TraverseCallback de FsRtlNotifyFullChangeDirectory.
Valeur de retour
None
Remarques
FsRtlNotifyFullReportChange est appelé par un système de fichiers lorsqu’un fichier est modifié afin que les irp de modification de notification en attente puissent être effectuées.
FsRtlNotifyFullReportChange recherche une structure de notification dans la liste des notifications qui correspond au filtre et au chemin d’accès spécifiés. Si une correspondance est trouvée, FsRtlNotifyFullReportChange termine tous les runtimes d’intégration en attente pour la structure de notification.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Plateforme cible | Universal |
| En-tête | ntifs.h (include Ntifs.h) |
| Bibliothèque | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | PASSIVE_LEVEL |
| Règles de conformité DDI | HwStorPortProhibitedDDIs(storport), PowerIrpDDis(wdm) |