Condividi tramite

FSCTL_WRITE_USN_CLOSE_RECORD IOCTL (winioctl.h)

  • Articolo

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

Osservazioni

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 di chiusura 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 un journal delle modifiche.

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 Sostenuto
Protocollo SMB (Server Message Block) 3.0 No
SMB 3.0 Transparent Failover (TFO) No
SMB 3.0 con condivisioni file con scalabilità orizzontale (SO) No
Cluster Shared Volume File System (CsvFS) Sì
 

operazioni transazionate

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

Fabbisogno

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)

Vedere anche

cambia journal

CreateFile

DeviceIoControl

OVERLAPPED

codici di controllo di gestione dei volumi