FSCTL_READ_FILE_USN_DATA IOCTL (winioctl.h)

  • Articolo

Recupera le informazioni sul numero di sequenza di aggiornamento (USN) sul journal di modifica per il file o la directory specificati.

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

C++ 
BOOL 
WINAPI 
DeviceIoControl( (HANDLE)       hDevice,         // handle to device
                 (DWORD) FSCTL_READ_FILE_USN_DATA, // 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

Commenti

Se la chiamata ha esito positivo, i membri della struttura restituita USN_RECORD_V2 o USN_RECORD_V3 sono validi ad eccezione dei membri seguenti: TimeStamp, Reason e SourceInfo. Il membro Usn rappresenta l'ultimo USN scritto nel journal per questo file o directory.

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 ReFS o 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.exe 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 con scalabilità orizzontale (SO) No
File system del volume condiviso del cluster (CsvFS) Sì

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

CreateFile

Deviceiocontrol

USN_RECORD

Codici di controllo della gestione del volume