Share via

FSCTL_CREATE_USN_JOURNAL IOCTL (winioctl.h)

  • Article

Crée un flux de journal de modification de nombre de séquences de mise à jour (USN) sur un volume cible ou modifie un flux de journal des modifications existant.

C++ 
BOOL 
WINAPI 
DeviceIoControl( (HANDLE) hDevice,              // handle to volume
                 FSCTL_CREATE_USN_JOURNAL,      // dwIoControlCode(LPVOID) lpInBuffer,           // input buffer
                 (DWORD) nInBufferSize,         // size of input buffer
                 NULL,                          // lpOutBuffer
                 0,                             // nOutBufferSize(LPDWORD) lpBytesReturned,     // number of bytes returned
                 (LPOVERLAPPED) lpOverlapped ); // OVERLAPPED structure

Remarques

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

Vous pouvez utiliser FSCTL_CREATE_USN_JOURNAL pour créer un flux de journal des modifications pour un volume. Après la création du flux, le système de fichiers NTFS gère un journal des modifications pour ce volume.

Vous pouvez également utiliser FSCTL_CREATE_USN_JOURNAL pour modifier un flux de journal des modifications existant. Si un flux de journal des modifications existe déjà, FSCTL_CREATE_USN_JOURNAL le définit sur les caractéristiques fournies dans la structure CREATE_USN_JOURNAL_DATA . Le flux de journal des modifications finit par s’agrandir ou est réduit à la nouvelle limite de taille que CREATE_USN_JOURNAL_DATA impose.

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 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 fsinfo ntfsinfo X:

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

Dans Windows Server 2012, cette fonction est prise 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

CREATE_USN_JOURNAL_DATA

Journaux des modifications

CreateFile

DeviceIoControl

OVERLAPPED

Codes de contrôle de gestion des volumes