Функция TmPreprepareComplete (wdm.h)
Подпрограмма TmPreprepareComplete уведомляет KTM о том, что вызывающий диспетчер ресурсов завершил предварительную подготовку данных транзакции.
Синтаксис
NTSTATUS TmPrePrepareComplete(
[in] PKENLISTMENT Enlistment,
[in] PLARGE_INTEGER TmVirtualClock
);
Параметры
[in] Enlistment
Указатель на объект зачисления. Компонент может получать этот указатель в качестве входных данных для процедуры обратного вызова ResourceManagerNotification . Кроме того, компонент может вызвать ObReferenceObjectByHandle и предоставить дескриптор объекта, указанный при предыдущем вызове ZwCreateEnlistment, TmCreateEnlistment или ZwOpenEnlistment .
[in] TmVirtualClock
Указатель на значение виртуальных часов. Этот параметр является необязательным и может иметь значение NULL.
Возвращаемое значение
TmPrepareComplete возвращает STATUS_SUCCESS, если операция выполнена успешно. В противном случае эта подпрограмма может возвращать одно из следующих значений:
| Код возврата | Описание |
|---|---|
|
Транзакция или ее зачисление находится в неправильном состоянии. Например, KTM не отправил уведомление TRANSACTION_NOTIFY_PREPARE. |
Подпрограмма может возвращать другие значения NTSTATUS.
Комментарии
Подпрограмма TmPreprepareComplete — это основанная на указателе версия подпрограммы ZwPrePrepareComplete .
Сведения о том, когда следует использовать подпрограммы KTM TmXxx вместо процедур ZwXxx , см. в разделе Использование подпрограмм TmXxx.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Доступно в Windows Vista и более поздних версиях операционной системы. |
| Целевая платформа | Универсальное |
| Верхняя часть | wdm.h (включая Wdm.h, Ntddk.h, Ntifs.h) |
| Библиотека | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | PASSIVE_LEVEL |