FSCTL_READ_USN_JOURNAL IOCTL (winioctl.h)

Article
06/27/2024

Récupère l’ensemble d’enregistrements de journal de modification de numéro de séquence de mise à jour (USN) entre deux valeurs USN spécifiées.

C++
BOOL WINAPI DeviceIoControl( (HANDLE) hDevice, // handle to volume (DWORD) FSCTL_READ_USN_JOURNAL, // 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_READ_USN_JOURNAL, // 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

Remarques

Pour connaître les implications des E/S superposées sur cette opération, consultez la section Remarques de la rubrique DeviceIoControl .

Il existe deux codes de contrôle DeviceIoControl qui retournent des enregistrements USN, FSCTL_READ_USN_JOURNAL et FSCTL_ENUM_USN_DATA. Utilisez ce dernier lorsque vous souhaitez obtenir une liste (énumération) des enregistrements USN entre deux USN. Utilisez l’ancien lorsque vous souhaitez sélectionner par USN.

Pour plus d’informations, consultez Création, modification et suppression d’un journal de modification.

Pour récupérer un handle vers 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	Supporté
Protocole SMB (Server Message Block) 3.0	Non
Basculement transparent SMB 3.0 (TFO)	Non
SMB 3.0 avec partages de fichiers avec montée en puissance parallèle (SO)	Non
Cluster Shared Volume File System (CsvFS)	Voir le commentaire

Une application peut rencontrer des faux positifs lors de la pause/reprise csvFs.

Exemples

Pour obtenir un exemple, consultez Marche à pied d’une mémoire tampon des enregistrements de journal de modification.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows XP [applications de bureau uniquement]
serveur minimum pris en charge	Windows Server 2003 [applications de bureau uniquement]
d’en-tête	winioctl.h (include Windows.h)