FSCTL_USN_TRACK_MODIFIED_RANGES IOCTL (winioctl.h)
Active la fonctionnalité de suivi des plages pour le flux de journal de modifications du nombre de séquences de mise à jour (USN) sur un volume cible, ou modifie les paramètres de suivi des plages déjà activés.
BOOL DeviceIoControl(
(HANDLE) hDevice, // handle to volume
FSCTL_USN_TRACK_MODIFIED_RANGES, // dwIoControlCode
(LPDWORD) lpInBuffer, // input buffer
(DWORD) nInBufferSize, // size of input buffer
(LPDWORD) lpOutBuffer, // lpOutbuffer
(DWORD) nOutBufferSize, // size of output buffer
(LPDWORD) lpBytesReturned, // number of bytes returned
(LPOVERLAPPED) lpOverlapped // OVERLAPPED structure
);
Remarques
Pour connaître les implications des E/S qui se chevauchent sur cette opération, consultez la section Remarques de la rubrique DeviceIoControl .
Vous pouvez utiliser FSCTL_USN_TRACK_MODIFIED_RANGES pour activer le suivi de plage pour la première fois pour un volume. Après l’activation du suivi de plage, l’état et les paramètres sont conservés pour ce volume et, au prochain redémarrage, le suivi de plage est initialisé lu à partir des paramètres persistants.
Vous pouvez également utiliser FSCTL_USN_TRACK_MODIFIED_RANGES pour modifier un paramètre de suivi de la plage de flux de journal des modifications existant. Si le suivi de plage existe déjà, FSCTL_USN_TRACK_MODIFIED_RANGES le définit sur les paramètres fournis dans la structure USN_TRACK_MODIFIED_RANGES . La taille du bloc ou le seuil de taille de fichier ne peuvent être réduits que par rapport aux valeurs précédentes. Une fois activée, la fonctionnalité de suivi des plages ne peut pas être désactivée, sauf si le journal est supprimé.
Pour récupérer un handle dans un volume, appelez CreateFile avec le paramètre lpFileName défini sur une chaîne sous la forme suivante :
\\.\X:
Dans la chaîne précédente, X est la lettre identifiant le lecteur sur lequel le volume apparaît. Le volume doit être NTFS 3.0 ou version ultérieure. Pour obtenir la version NTFS d’un volume, ouvrez une invite de commandes avec des droits d’accès Administrateur et exécutez la commande suivante :
fsutil fsinfo ntfsinfoX:
où X correspond à la lettre de lecteur du volume.
Configuration requise
Condition requise | Valeur |
---|---|
Client minimal pris en charge | Windows 8.1 [applications de bureau uniquement] |
Serveur minimal pris en charge | Windows Server 2012 R2 [applications de bureau uniquement] |
En-tête | winioctl.h (inclure Windows.h) |
Voir aussi
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour