Partager via

FSCTL_READ_FILE_USN_DATA IOCTL (winioctl.h)

  • Article

Récupère les informations de journal de modification du numéro de séquence de mise à jour (USN) pour le fichier ou le répertoire spécifié.

Pour effectuer cette opération, appelez la fonction DeviceIoControl avec les paramètres suivants.

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

Remarques

Si l’appel réussit, les membres de la structure de USN_RECORD_V2 ou de USN_RECORD_V3 retournées sont valides, à l’exception des membres suivants : TimeStamp, Reasonet SourceInfo. Le membre Usn représente le dernier USN écrit dans le journal de ce fichier ou répertoire.

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 ReFS ou NTFS 3.0 ou version ultérieure. Pour obtenir la version NTFS d’un volume, ouvrez une invite de commandes avec les droits d’accès administrateur et exécutez la commande suivante :

FSUtil.exe FSInfo NTFSInfo X:

où X est la lettre de lecteur du volume.

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) Oui

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)

Voir aussi

CreateFile

DeviceIoControl

USN_RECORD

codes de contrôle de gestion des volumes