FSCTL_WRITE_USN_CLOSE_RECORD IOCTL (winioctl.h)

Artikel
06/27/2024

Menghasilkan rekaman dalam aliran perubahan nomor urutan pembaruan (USN) untuk file input. Rekaman ini akan memiliki bendera USN_REASON_CLOSE.

Untuk melakukan operasi ini, panggil fungsi DeviceIoControl dengan parameter berikut.

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

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

Komentar

Untuk implikasi I/O yang tumpang tindih pada operasi ini, lihat bagian Keterangan untuk DeviceIoControl.

Anda dapat menggunakan FSCTL_WRITE_USN_CLOSE_RECORD untuk memaksa catatan dekat ke dalam jurnal perubahan untuk handel input. Catatan penutupan juga akan berisi alasan USN saat ini untuk file ini. Buffer output akan mengembalikan nilai USN yang terkait dengan operasi ini.

Untuk informasi selengkapnya, lihat Membuat, Memodifikasi, dan Menghapus Change Journal.

Untuk mengambil handel ke volume, panggil CreateFile dengan parameter lpFileName diatur ke string dalam formulir berikut:

\\.\X:

Dalam string sebelumnya, X adalah huruf yang mengidentifikasi drive tempat volume muncul. Volume harus NTFS 3.0 atau yang lebih baru. Untuk mendapatkan versi volume NTFS, buka prompt perintah dengan hak akses Administrator dan jalankan perintah berikut:

fsutil fsinfo ntfsinfo X:

di mana X adalah huruf drive volume.

Di Windows 8 dan Windows Server 2012, kode ini didukung oleh teknologi berikut.

Teknologi	Didukung
Protokol Server Message Block (SMB) 3.0	Tidak
Failover Transparan (TFO) SMB 3.0	Tidak
SMB 3.0 dengan Scale-out File Shares (SO)	Tidak
Sistem File Volume Bersama Kluster (CsvFS)	Ya

Operasi Ditransaksikan

Jika FSCTL_WRITE_USN_CLOSE_RECORD dipanggil dengan handel yang dikunci oleh transaksi, itu selalu gagal.

Persyaratan

Syarat	Nilai
klien minimum yang didukung	Windows XP [hanya aplikasi desktop]
server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Header	winioctl.h (termasuk Windows.h)

Lihat juga

Mengubah Jurnal

CreateFile

DeviceIoControl

TUMPANG TINDIH

Kode Kontrol Manajemen Volume

Bagikan melalui