FSCTL_WRITE_USN_CLOSE_RECORD IOCTL (winioctl.h)

Articolo
08/27/2023

Genera un record nel flusso del journal di modifica USN (Update Sequence Number) per il file di input. Questo record avrà il flag USN_REASON_CLOSE .

Per eseguire questa operazione, chiamare la funzione DeviceIoControl con i parametri seguenti.

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

Commenti

Per le implicazioni dell'I/O sovrapposto in questa operazione, vedere la sezione Osservazioni per DeviceIoControl.

È possibile usare FSCTL_WRITE_USN_CLOSE_RECORD per forzare un record vicino nel journal delle modifiche per l'handle di input. Il record di chiusura conterrà anche eventuali motivi USN correnti per questo file. Il buffer di output restituirà il valore USN associato a questa operazione.

Per altre informazioni, vedere Creazione, modifica ed eliminazione di una modifica Journal.

Per recuperare un handle in un volume, chiamare CreateFile con il parametro lpFileName impostato su una stringa nel formato seguente:

\.\X:

Nella stringa precedente , X è la lettera che identifica l'unità in cui viene visualizzato il volume. Il volume deve essere NTFS 3.0 o versione successiva. Per ottenere la versione NTFS di un volume, aprire un prompt dei comandi con diritti di accesso amministratore ed eseguire il comando seguente:

fsutil fsinfo ntfsinfo X:

dove X è la lettera di unità del volume.

In Windows 8 e Windows Server 2012 questo codice è supportato dalle tecnologie seguenti.

Tecnologia	Supportato
Protocollo SMB (Server Message Block) 3.0	No
Failover trasparente SMB 3.0 (TFO)	No
SMB 3.0 con condivisioni file di scalabilità orizzontale (SO)	No
File system del volume condiviso cluster (CsvFS)	Sì

Operazioni transazionate

Se FSCTL_WRITE_USN_CLOSE_RECORD viene chiamato con un handle bloccato da una transazione, l'operazione ha sempre esito negativo.

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Intestazione	winioctl.h (include Windows.h)

Vedi anche

Modificare i giornali di registrazione

CreateFile

Deviceiocontrol

SOVRAPPOSTA

Codici di controllo della gestione del volume