Функция ReadOnlyEnlistment (ktmw32.h)

Запрашивает преобразование указанного зачисления в зачисление только для чтения. Зачисление только для чтения не может участвовать в результатах транзакции и не записывается для восстановления.

Синтаксис

BOOL ReadOnlyEnlistment(
  [in] HANDLE         EnlistmentHandle,
  [in] PLARGE_INTEGER TmVirtualClock
);

Параметры

[in] EnlistmentHandle

Дескриптор для зачисления.

[in] TmVirtualClock

Последнее значение виртуальных часов, полученное для этого зачисления. Если указать значение NULL, значение виртуальных часов не изменяется. См . LARGE_INTEGER.

Чтобы изменить значение виртуальных часов, это значение должно быть больше текущего значения, возвращаемого в уведомлении COMMIT.

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

Если функция выполняется успешно, возвращается ненулевое значение.

Если функция завершается ошибкой, возвращаемое значение равно нулю (0). Чтобы получить расширенные сведения об ошибке, вызовите функцию GetLastError .

В следующем списке указаны возможные коды ошибок:

Комментарии

Если диспетчеру ресурсов больше не нужно участвовать в транзакции без отката транзакции, он должен вызвать ReadOnlyEnlistment перед закрытием дескриптора зачисления.

Требования

Требование Значение
Минимальная версия клиента Windows Vista
Минимальная версия сервера Windows Server 2008
Целевая платформа Windows
Header ktmw32.h
Библиотека Ktmw32.lib
DLL Ktmw32.dll

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

GetCurrentClockTransactionManager

Функции диспетчера транзакций ядра

ReadOnlyEnlistment