FSCTL_CREATE_USN_JOURNAL IOCTL (winioctl.h)
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) |