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 (TFO) | Нет |
| SMB 3.0 с масштабируемыми общими папками (SO) | Нет |
| Файловая система общего тома кластера (CSVFS) | Да |
Требования
| Требование | Ценность |
|---|---|
| минимальные поддерживаемые клиентские | Windows XP [только классические приложения] |
| минимальный поддерживаемый сервер | Windows Server 2003 [только классические приложения] |
| заголовка | winioctl.h (включая Windows.h) |