FSCTL_ENUM_USN_DATA IOCTL (winioctl.h)
Énumère les données de numéro de séquence de mise à jour (USN) entre deux limites spécifiées pour obtenir master enregistrements de table de fichiers (MFT).
Pour effectuer cette opération, appelez la fonction DeviceIoControl avec les paramètres suivants.
| C++ |
|---|
BOOL
WINAPI
DeviceIoControl( (HANDLE) hDevice, // handle to volume
(DWORD) FSCTL_ENUM_USN_DATA, // dwIoControlCode(LPVOID) lpInBuffer, // input buffer
(DWORD) nInBufferSize, // size of input buffer
(LPVOID) lpOutBuffer, // output buffer
(DWORD) nOutBufferSize, // size of output buffer
(LPDWORD) lpBytesReturned, // number of bytes returned
(LPOVERLAPPED) lpOverlapped ); // OVERLAPPED structure);
|
Notes
Pour connaître les implications des E/S qui se chevauchent sur cette opération, consultez la section Remarques de la rubrique DeviceIoControl .
Pour énumérer des fichiers sur un volume, utilisez l’opération FSCTL_ENUM_USN_DATA une ou plusieurs fois. Lors du premier appel, définissez le point de départ, le membre StartFileReferenceNumber de la structure MFT_ENUM_DATA , sur (DWORDLONG)0. Chaque appel à FSCTL_ENUM_USN_DATA récupère le point de départ de l’appel suivant comme première entrée dans la mémoire tampon de sortie.
En comparant Pour identifier les modifications récentes apportées à un volume, utilisez le code de contrôle FSCTL_READ_USN_JOURNAL .
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.
Dans Windows 8 et Windows Server 2012, ce code est pris en charge par les technologies suivantes.
| Technologie | Pris en charge |
|---|---|
| Protocole SMB (Server Message Block) 3.0 | Non |
| Basculement transparent (TFO) SMB 3.0 | Non |
| SMB 3.0 avec partages de fichiers avec montée en puissance sortante (SO) | Non |
| Cluster Shared Volume File System (CsvFS) | Oui |
Configuration requise
| Client minimal pris en charge | Windows XP [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows Server 2003 [applications de bureau uniquement] |
| En-tête | winioctl.h (inclure Windows.h) |