FSCTL_READ_USN_JOURNAL IOCTL (winioctl.h)

Articolo
06/27/2024

Recupera il set di record del journal di modifica USN (Update Sequence Number) tra due valori USN specificati.

C++
BOOL WINAPI DeviceIoControl( (HANDLE) hDevice, // handle to volume (DWORD) FSCTL_READ_USN_JOURNAL, // dwIoControlCode (LPVOID) lpInBuffer, // input buffer (DWORD) nInBufferSize, // size of input buffer (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
                 (DWORD) FSCTL_READ_USN_JOURNAL, // dwIoControlCode
                 (LPVOID)       lpInBuffer,      // input buffer
                 (DWORD)        nInBufferSize,   // size of input buffer
                 (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 dell'argomento DeviceIoControl.

Esistono due codici di controllo DeviceIoControl che restituiscono record USN, FSCTL_READ_USN_JOURNAL e FSCTL_ENUM_USN_DATA. Usare quest'ultimo quando si desidera un elenco (enumerazione) dei record USN tra due USN. Usare il primo quando si vuole selezionare per USN.

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.

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)	Vedere il commento

Un'applicazione può riscontrare falsi positivi in file CSVFS in pausa/ripresa.

Esempi

Per un esempio, vedere Walking a Buffer of Change Journal Records.

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)