Поделиться через

Метод IFhConfigMgr::QueryProtectionStatus (fhcfg.h)

  • Статья

Извлекает текущее состояние защиты журнала файлов.

Примечание

IFhConfigMgr является нерекомендуемым и может быть изменен или недоступен в будущих выпусках.

Синтаксис

HRESULT QueryProtectionStatus(
  [out] DWORD *ProtectionState,
  [out] BSTR  *ProtectedUntilTime
);

Параметры

[out] ProtectionState

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

Значение Значение
FH_STATE_NOT_TRACKED
0x00
 Состояние защиты журнала файлов неизвестно, так как служба журнала файлов не запущена или текущий пользователь в ней не отслеживается. Это значение не может быть ORed with FH_STATE_RUNNING (0x100).
FH_STATE_OFF
0x01
 Защита журнала файлов не включена для текущего пользователя. Резервные копии файлов не будут создаваться. Это значение не может быть ORed with FH_STATE_RUNNING (0x100).
FH_STATE_DISABLED_BY_GP
0x02
 Защита журнала файлов отключена групповая политика. Резервные копии файлов не будут создаваться. Это значение не может быть ORed with FH_STATE_RUNNING (0x100).
FH_STATE_FATAL_CONFIG_ERROR
0x03
 В одном из файлов, где хранятся внутренние сведения журнала файлов для текущего пользователя, возникает неустранимая ошибка. Резервные копии файлов не будут создаваться. Это значение не может быть ORed with FH_STATE_RUNNING (0x100).
FH_STATE_TARGET_ACCESS_DENIED
0x0E
 Текущий пользователь не имеет разрешения на запись для назначенного в данный момент целевого объекта. Резервные копии версий файлов создаваться не будут. Это значение можно задать с помощью FH_STATE_RUNNING (0x100), чтобы указать, что сейчас выполняется цикл резервного копирования для текущего пользователя.
FH_STATE_TARGET_VOLUME_DIRTY
0x0F
 Назначенный в данный момент целевой объект помечен как грязное. Резервные копии версий файлов будут созданы только после запуска служебной программы Chkdsk . Это значение можно задать с помощью FH_STATE_RUNNING (0x100), чтобы указать, что сейчас выполняется цикл резервного копирования для текущего пользователя.
FH_STATE_TARGET_FULL_RETENTION_MAX
0x10
 Назначенный в данный момент целевой объект не имеет достаточного пространства для хранения резервных копий файлов из область защиты журнала файлов, и для хранения уже задана наиболее агрессивная политика. Журнал файлов обеспечивает пониженный уровень защиты. Это значение можно задать с помощью FH_STATE_RUNNING (0x100), чтобы указать, что сейчас выполняется цикл резервного копирования для текущего пользователя.
FH_STATE_TARGET_FULL
0x11
 У назначенного в настоящее время целевого объекта недостаточно места для хранения резервных копий файлов из область защиты журнала файлов. Журнал файлов обеспечивает пониженный уровень защиты. Это значение можно задать с помощью FH_STATE_RUNNING (0x100), чтобы указать, что сейчас выполняется цикл резервного копирования для текущего пользователя.
FH_STATE_STAGING_FULL
0x12
 Кэш журнала файлов на одном из локальных дисков не имеет достаточного места для хранения резервных копий файлов из область защиты журнала файлов. Журнал файлов обеспечивает пониженный уровень защиты. Это значение можно задать с помощью FH_STATE_RUNNING (0x100), чтобы указать, что сейчас выполняется цикл резервного копирования для текущего пользователя.
FH_STATE_TARGET_LOW_SPACE_RETENTION_MAX
0x13
 Для назначенного в настоящее время целевого объекта недостаточно свободного места, и для хранения уже задана наиболее агрессивная политика. Уровень защиты журнала файлов, скорее всего, в ближайшее время снизится. Это значение можно задать с помощью FH_STATE_RUNNING (0x100), чтобы указать, что сейчас выполняется цикл резервного копирования для текущего пользователя.
FH_STATE_TARGET_LOW_SPACE
0x14
 У назначенного в настоящее время целевого объекта недостаточно свободного места. Уровень защиты журнала файлов, скорее всего, в ближайшее время снизится. Это значение можно задать с помощью FH_STATE_RUNNING (0x100), чтобы указать, что сейчас выполняется цикл резервного копирования для текущего пользователя.
FH_STATE_TARGET_ABSENT
0x15
 Назначенный в настоящее время целевой объект был недоступен для резервного копирования в течение значительного периода времени, что приводит к снижению уровня защиты журнала файлов. Это значение можно задать с помощью FH_STATE_RUNNING (0x100), чтобы указать, что сейчас выполняется цикл резервного копирования для текущего пользователя.
FH_STATE_TOO_MUCH_BEHIND
0x16
 В защищенные файлы или область защиты было внесено слишком много изменений. Уровень защиты журнала файлов, скорее всего, снизится, если пользователь явно не инициирует немедленное резервное копирование вместо того, чтобы полагаться на регулярные циклы резервного копирования, которые будут выполняться в фоновом режиме. Это значение можно задать с помощью FH_STATE_RUNNING (0x100), чтобы указать, что сейчас выполняется цикл резервного копирования для текущего пользователя.
FH_STATE_NO_ERROR
0xFF
 Резервное копирование журнала файлов выполняется регулярно, ошибки не обнаруживаются, обеспечивается оптимальный уровень защиты журнала файлов. Это значение можно задать с помощью FH_STATE_RUNNING (0x100), чтобы указать, что сейчас выполняется цикл резервного копирования для текущего пользователя.

[out] ProtectedUntilTime

Получает указатель на строку, выделенную с помощью SysAllocString, содержащую дату и время, до которых будут защищены все файлы в область защиты журнала файлов. Дата и время форматируются в соответствии с языковым стандартом системы. Если дата и время неизвестны, возвращается пустая строка.

Файл считается защищенным до определенного момента времени, если выполняется одно из следующих условий:

  • Существует версия этого файла, которая была записана в этот момент времени или после нее и была полностью скопирована в назначенный в данный момент целевой объект резервного копирования.
  • Файл был создан или включен в область защиты журнала файлов в этот момент времени или после него.

Возвращаемое значение

Если этот метод завершается успешно, он возвращает S_OK. В противном случае возвращается код ошибки HRESULT , например одно из значений, определенных в файле заголовка FhErrors.h.

Комментарии

Вызывающий объект отвечает за освобождение памяти, выделенной для ProtectedUntilTime , путем вызова SysFreeString .

Состояние защиты указывает рабочее состояние журнала файлов, а также дату и время, до которых будут защищены все файлы в область защиты.

Если целевой объект заполнен или отключен, функция журнала файлов обеспечит сниженный уровень защиты следующим образом:

  • Резервные копии файлов будут создаваться в кэше журнала файлов на одном из локальных дисков.
  • Если кэш заполняется в течение этого времени, старые копии будут удалены из кэша для резервного копирования новых копий.
  • Если в целевом объекте мало свободного места, уровень защиты с пониженным уровнем начнется после заполнения целевого объекта.

Требования

   
Минимальная версия клиента Windows 8 [только классические приложения]
Минимальная версия сервера Windows Server 2012 [только классические приложения]
Целевая платформа Windows
Header fhcfg.h

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

FhConfigMgr

IFhConfigMgr