FSCTL_ENUM_USN_DATA IOCTL (winioctl.h)

Article
06/07/2023

É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);

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)