Partager via

FSCTL_CREATE_USN_JOURNAL IOCTL (winioctl.h)

  • Article

Crée un flux de journal de modification de numéro de séquence de mise à jour (USN) sur un volume cible ou modifie un flux de journal de modification 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 superposées 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 conserve un journal de modification 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 de modification existe déjà, FSCTL_CREATE_USN_JOURNAL la définit sur les caractéristiques fournies dans la structure CREATE_USN_JOURNAL_DATA. Le flux de journal de modification est finalement plus grand 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 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 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 fsinfo ntfsinfo X:

où X est la lettre de lecteur du volume.

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

CREATE_USN_JOURNAL_DATA

journal des modifications

CreateFile

DeviceIoControl

SUPERPOSÉ

codes de contrôle de gestion des volumes