FSCTL_READ_USN_JOURNAL IOCTL (winioctl.h)

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

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)

Vedere anche

cambia journal

CreateFile

DeviceIoControl

FSCTL_ENUM_USN_DATA

GetOverlappedResult

GetQueuedCompletionStatus

OVERLAPPED

READ_USN_JOURNAL_DATA

USN_RECORD

codici di controllo di gestione dei volumi