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 oppure modifica un flusso del journal di 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

Commenti

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

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

È anche possibile usare FSCTL_CREATE_USN_JOURNAL per modificare un flusso di journal di modifiche esistente. Se esiste già un flusso del journal di modifica, FSCTL_CREATE_USN_JOURNAL imposta le caratteristiche fornite nella struttura CREATE_USN_JOURNAL_DATA . Il flusso del journal di modifica diventa 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 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 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 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

CREATE_USN_JOURNAL_DATA

Modificare i journal

CreateFile

Deviceiocontrol

SOVRAPPOSTA

Codici di controllo della gestione del volume