Condividi tramite

FSCTL_READ_FILE_USN_DATA IOCTL (winioctl.h)

  • Articolo

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

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

Osservazioni

Se la chiamata ha esito positivo, i membri della struttura USN_RECORD_V2 o USN_RECORD_V3 restituita sono validi, ad eccezione dei membri seguenti: TimeStamp, Reasone 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 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 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 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ì

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

CreateFile

DeviceIoControl

USN_RECORD

codici di controllo di gestione dei volumi