FSCTL_WRITE_USN_CLOSE_RECORD IOCTL (winioctl.h)
Génère un enregistrement dans le flux de journal des modifications du numéro de séquence de mise à jour (USN) pour le fichier d’entrée. Cet enregistrement aura l’indicateur USN_REASON_CLOSE.
Pour effectuer cette opération, appelez la fonction DeviceIoControl avec les paramètres suivants.
| C++ |
|---|
BOOL
WINAPI
DeviceIoControl( (HANDLE) hDevice, // handle to volume
FSCTL_WRITE_USN_CLOSE_RECORD, // dwIoControlCodeNULL, // lpInBuffer0, // nInBufferSize(LPVOID) lpOutBuffer, // output buffer
(DWORD) nOutBufferSize, // size of output buffer
(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 pour DeviceIoControl.
Vous pouvez utiliser FSCTL_WRITE_USN_CLOSE_RECORD pour forcer un enregistrement de fermeture dans le journal de modification pour le handle d’entrée. L’enregistrement de fermeture contient également toutes les raisons USN actuelles de ce fichier. La mémoire tampon de sortie retourne la valeur USN associée à cette opération.
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 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 |
opérations transactionnelles
Si FSCTL_WRITE_USN_CLOSE_RECORD est appelée avec un handle verrouillé par une transaction, il échoue toujours.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) |