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

  • Статья

[Корпорация Майкрософт настоятельно рекомендует разработчикам использовать альтернативные средства для удовлетворения потребностей вашего приложения. Многие сценарии, для работы с которыми был разработан TxF, можно реализовать с помощью более простых и доступных методов. Кроме того, TxF может быть недоступен в будущих версиях Microsoft Windows. Дополнительные сведения и альтернативы TxF см. в разделе Альтернативы использованию транзакционной NTFS.]

Содержит сведения о базовой и последней версиях указанного файла.

Синтаксис

typedef struct _TXFS_GET_TRANSACTED_VERSION {
  DWORD ThisBaseVersion;
  DWORD LatestVersion;
  WORD  ThisMiniVersion;
  WORD  FirstMiniVersion;
  WORD  LatestMiniVersion;
} TXFS_GET_TRANSACTED_VERSION, *PTXFS_GET_TRANSACTED_VERSION;

Члены

ThisBaseVersion

Версия файла, с которым открыт этот дескриптор. Этот элемент может иметь одно из следующих значений.

Значение Значение
TXFS_TRANSACTED_VERSION_NONTRANSACTED
0xFFFFFFFE
 Файл не является файлом с транзакцией.
TXFS_TRANSACTED_VERSION_UNCOMMITTED
0xFFFFFFFF
 Файл был открыт как модуль записи транзакций.
 

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

LatestVersion

Последняя зафиксированная версия файла.

ThisMiniVersion

Если дескриптор миниверсии открыт, этот элемент содержит идентификатор миниверсии. Если дескриптор не открыт, этот элемент равен нулю (0).

FirstMiniVersion

Первая доступная мини-версия для этого файла. Если миниверсий нет или они не видны транзакции, привязанной к дескриптору файла, это поле равно нулю (0).

LatestMiniVersion

Последняя доступная миниверсия для этого файла. Если миниверсий нет или они не видны транзакции, привязанной к дескриптору файла, это поле равно нулю (0).

Комментарии

Номер базовой версии остается неизменным в течение всего времени существования дескриптора. Номер последней версии увеличивается до тех пор, пока дескриптор по-прежнему открыт для файла и изменения зафиксированы. При закрытии дескриптора номер версии сбрасывается до нуля.

Требования

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

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

FSCTL_TXFS_GET_TRANSACTED_VERSION