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

  • Статья

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

Структура FSCTL_TXFS_SAVEPOINT_INFORMATION определяет выполняемую операцию и транзакцию.

Синтаксис

typedef struct _TXFS_SAVEPOINT_INFORMATION {
  HANDLE KtmTransaction;
  DWORD  ActionCode;
  DWORD  SavepointId;
} TXFS_SAVEPOINT_INFORMATION, *PTXFS_SAVEPOINT_INFORMATION;

Члены

KtmTransaction

Обработка транзакции, для которой выполняется операция сохранения точки.

ActionCode

Указывает действие точки сохранения, которое необходимо выполнить. Допустимые значения:

Значение Значение
TXFS_SAVEPOINT_SET
1 (0x1)
 Создает новую точку сохранения.
TXFS_SAVEPOINT_ROLLBACK
2 (0x2)
 Выполняет откат до точки сохранения, указанной элементом SavepointId .
TXFS_SAVEPOINT_CLEAR
4 (0x4)
 Очищает последнюю заданную точку сохранения для указанной транзакции.
TXFS_SAVEPOINT_CLEAR_ALL
16 (0x10)
 Очищает все точки сохранения для транзакции.

SavepointId

Если actionCodeTXFS_SAVEPOINT_SET, в выходных данных возвращается только что созданный идентификатор точки сохранения.

Если actionCodeTXFS_ROLLBACK_TO_SAVEPOINT, то при входных данных указывает идентификатор точки сохранения для отката. Остается неизменным в выходных данных.

Если actionCode является TXFS_SAVEPOINT_CLEAR или TXFS_SAVEPOINT_CLEAR_ALL, этот элемент не используется; поэтому на входных данных укажите ЗНАЧЕНИЕ NULL.

Требования

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

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

FSCTL_TXFS_SAVEPOINT_INFORMATION