структура DELETE_USN_JOURNAL_DATA (winioctl.h)

  • Статья

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

Синтаксис

typedef struct {
  DWORDLONG UsnJournalID;
  DWORD     DeleteFlags;
} DELETE_USN_JOURNAL_DATA, *PDELETE_USN_JOURNAL_DATA;

Члены

UsnJournalID

Идентификатор удаляемого журнала изменений.

Если журнал активен и запрашивается удаление путем установки флага USN_DELETE_FLAG_DELETE в элементе DeleteFlags , этот идентификатор должен указывать журнал изменений для текущего тома. Используйте FSCTL_QUERY_USN_JOURNAL для получения идентификатора этого журнала изменений. Если в этом случае идентификатор не относится к журналу изменений текущего тома, FSCTL_DELETE_USN_JOURNAL сбоем.

Если уведомление вместо удаления запрашивается путем установки только флага USN_DELETE_FLAG_NOTIFY в DeleteFlags, UsnJournalID игнорируется.

DeleteFlags

Указывает, выполняется ли удаление или уведомление об удалении, или и то, и другое. Элемент DeleteFlags должен содержать одно или оба из следующих значений.

Значение Значение
USN_DELETE_FLAG_DELETE
0x00000001
 Если этот флаг установлен, а флаг USN_DELETE_FLAG_NOTIFY не задан, операция FSCTL_DELETE_USN_JOURNAL запускает процесс удаления журнала и возвращается немедленно. При необходимости процесс удаления журнала продолжается во время перезапуска системы.

Если этот флаг установлен и флаг USN_DELETE_FLAG_NOTIFY также установлен, происходит удаление и уведомление. Если этот флаг установлен и журнал активен, необходимо указать идентификатор журнала изменений для текущего тома в UsnJournalID , иначе операция завершится ошибкой. Если журнал не активен, usnJournalID игнорируется и журнал удаляется.
USN_DELETE_FLAG_NOTIFY
0x00000002
 Если этот флаг установлен, вызов настраивает уведомление о завершении удаления. Запрос на удаление журнала завершается после завершения процесса удаления журнала. Если этот флаг установлен, а флаг USN_DELETE_FLAG_DELETE не установлен, вызов настраивает уведомление об удалении, которое уже может выполняться. Например, при запуске приложения он может использовать этот флаг, чтобы определить, выполняется ли удаление.

Если этот флаг установлен и также установлен флаг USN_DELETE_FLAG_DELETE, происходит как удаление, так и уведомление. Уведомление выполняется с помощью порта завершения ввода-вывода или другого механизма асинхронного уведомления о событиях.

Комментарии

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

Требования

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

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

FSCTL_DELETE_USN_JOURNAL

FSCTL_QUERY_USN_JOURNAL