Condividi tramite

FSCTL_CREATE_USN_JOURNAL IOCTL (winioctl.h)

  • Articolo

Crea un flusso del journal di modifica del numero di sequenza di aggiornamento (USN) in un volume di destinazione o modifica un flusso del journal delle modifiche esistente.

C++ 
BOOL 
WINAPI 
DeviceIoControl( (HANDLE) hDevice,              // handle to volume
                 FSCTL_CREATE_USN_JOURNAL,      // dwIoControlCode(LPVOID) lpInBuffer,           // input buffer
                 (DWORD) nInBufferSize,         // size of input buffer
                 NULL,                          // lpOutBuffer
                 0,                             // nOutBufferSize(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.

È possibile usare FSCTL_CREATE_USN_JOURNAL per creare un nuovo flusso del journal delle modifiche per un volume. Dopo la creazione del flusso, il file system NTFS gestisce un journal delle modifiche per tale volume.

È anche possibile usare FSCTL_CREATE_USN_JOURNAL per modificare un flusso del journal delle modifiche esistente. Se esiste già un flusso del journal delle modifiche, FSCTL_CREATE_USN_JOURNAL imposta le caratteristiche specificate nella struttura CREATE_USN_JOURNAL_DATA. Il flusso del journal delle modifiche diventa infine più grande o viene tagliato al nuovo limite di dimensioni che CREATE_USN_JOURNAL_DATA impone.

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 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 fsinfo ntfsinfo X:

dove X è la lettera di unità del volume.

In Windows Server 2012 questa funzione è supportata 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

CREATE_USN_JOURNAL_DATA

cambia journal

CreateFile

DeviceIoControl

OVERLAPPED

codici di controllo di gestione dei volumi