FSCTL_ENUM_USN_DATA IOCTL (winioctl.h)

  • Articolo

Enumera i dati del numero di sequenza di aggiornamento (USN) tra due limiti specificati per ottenere record MFT (Master File Table).

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

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

Per le implicazioni dell'I/O sovrapposto in questa operazione, vedere la sezione Osservazioni dell'argomento DeviceIoControl .

Per enumerare i file in un volume, usare l'operazione di FSCTL_ENUM_USN_DATA una o più volte. Nella prima chiamata impostare il punto iniziale, il membro StartFileReferenceNumber della struttura MFT_ENUM_DATA su (DWORDLONG)0. Ogni chiamata a FSCTL_ENUM_USN_DATA recupera il punto iniziale per la chiamata successiva come prima voce nel buffer di output.

Confrontando Per identificare le modifiche recenti a un volume, usare il codice di controllo FSCTL_READ_USN_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 NTFS.

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

Requisiti

   
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

FSCTL_READ_USN_JOURNAL

GetOverlappedResult

MFT_ENUM_DATA

SOVRAPPOSTA

USN_RECORD

Codici di controllo della gestione del volume