Share via

FSCTL_READ_FILE_USN_DATA IOCTL (winioctl.h)

  • Article

Récupère les informations du journal de modifications du nombre de séquences de mise à jour (USN) pour le fichier ou 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 USN_RECORD_V2 ou USN_RECORD_V3 retournée sont valides, à l’exception des membres suivants : TimeStamp, Reason et SourceInfo. Le membre Usn représente le dernier USN écrit dans le journal pour 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 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 ReFS ou 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.exe FSInfo NTFSInfo X:

où X correspond à la lettre de lecteur du volume.

Dans Windows 8 et Windows Server 2012, ce code est pris en charge par les technologies suivantes.

Technologie Prise en charge
Protocole Server Message Block (SMB) 3.0 No
Basculement transparent SMB 3.0 (TFO) No
SMB 3.0 avec partages de fichiers avec montée en puissance parallèle (SO) No
Système de fichiers du volume partagé de cluster (CsvFS) Oui

Configuration requise

Condition requise Valeur
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)

Voir aussi

CreateFile

DeviceIoControl

USN_RECORD

Codes de contrôle de gestion des volumes