FSCTL_CREATE_USN_JOURNAL IOCTL (winioctl.h)

  • Статья

Создает поток журнала изменений последовательности обновления (USN) для целевого тома или изменяет существующий поток журнала изменений.

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

Комментарии

Сведения о последствиях перекрывающихся операций ввода-вывода для этой операции см. в разделе Примечания статьи DeviceIoControl .

С помощью FSCTL_CREATE_USN_JOURNAL можно создать новый поток журнала изменений для тома. После создания потока файловая система NTFS ведет журнал изменений для этого тома.

Вы также можете использовать FSCTL_CREATE_USN_JOURNAL для изменения существующего потока журнала изменений. Если поток журнала изменений уже существует, FSCTL_CREATE_USN_JOURNAL задает для него характеристики, указанные в структуре CREATE_USN_JOURNAL_DATA . Поток журнала изменений в конечном итоге становится больше или обрезается до нового ограничения размера, установленного CREATE_USN_JOURNAL_DATA .

Дополнительные сведения см. в статье Создание, изменение и удаление Журнал изменений.

Чтобы получить дескриптор тома, вызовите CreateFile с параметром lpFileName , для которого задана строка в следующей форме:

\.\X:

В предыдущей строке X — это буква, обозначающая диск, на котором отображается том. Том должен быть NTFS 3.0 или более поздней версии. Чтобы получить версию NTFS тома, откройте командную строку с правами доступа администратора и выполните следующую команду:

fsutil fsinfo ntfsinfo X:

где X — буква диска тома.

В Windows Server 2012 эта функция поддерживается следующими технологиями.

Технология Поддерживается
Протокол SMB 3.0 Нет
SMB 3.0 Transparent Failover (TFO) Нет
SMB 3.0 с масштабируемыми общими папками (SO) Нет
Файловая система общего тома кластера (CSVFS) Да

Требования

Требование Значение
Минимальная версия клиента Windows XP [только классические приложения]
Минимальная версия сервера Windows Server 2003 [только классические приложения]
Верхняя часть winioctl.h (включая Windows.h)

См. также раздел

CREATE_USN_JOURNAL_DATA

Изменить журналы

CreateFile

DeviceIoControl

ПЕРЕКРЫВАЮЩИХСЯ

Управляющие коды для управления томами