FsRtlNotifyFullReportChange, fonction (ntifs.h)
La routine FsRtlNotifyFullReportChange termine les runtimes d’intégration des modifications 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 d’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
Offset 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 FullTargetName chaîne, mais avec tous les noms courts remplacés par les noms longs correspondants.
[in] FilterMatch
Masque de bits des 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 s’il est présent. 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 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 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 | Un ID d’objet pour un fichier n’a pas pu être tunnelisé, car son ID d’objet correspond à l’ID d’un fichier déjà existant. |
| FILE_ACTION_TUNNELLED_ID_COLLISION | Un ID d’objet pour un fichier n’a pas pu être tunnelisé, 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 vérification de traversée dans le cas d’une arborescence surveillée. Pour plus d’informations, consultez le paramètre TraverseCallback de FsRtlNotifyFullChangeDirectory.
Valeur de retour
Aucun
Remarques
FsRtlNotifyFullReportChange est appelée par un système de fichiers lorsqu’un fichier est modifié afin qu’il soit possible d’informer les irps de modification en attente.
FsRtlNotifyFullReportChange recherche une structure de notification dans la liste de notification qui correspond au filtre et au chemin d’accès spécifiés. Si une correspondance est trouvée, FsRtlNotifyFullReportChange termine toutes les irps en attente pour la structure de notification.
Exigences
| Exigence | Valeur |
|---|---|
| plateforme cible | Universel |
| d’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) |