Функция NtPrePrepareComplete (wdm.h)
Программа ZwPrePrepareComplete уведомляет KTM о том, что вызывающий диспетчер ресурсов завершил предварительную подготовку данных транзакции.
Синтаксис
__kernel_entry NTSYSCALLAPI NTSTATUS NtPrePrepareComplete(
[in] HANDLE EnlistmentHandle,
[in, optional] PLARGE_INTEGER TmVirtualClock
);
Параметры
[in] EnlistmentHandle
Дескриптор объекта перечисления, полученный предыдущим вызовом ZwCreateEnlistment или ZwOpenEnlistment. Дескриптор должен иметь ENLISTMENT_SUBORDINATE_RIGHTS доступ к объекту.
[in, optional] TmVirtualClock
Указатель на значение виртуальных часов. Этот параметр является необязательным и может быть null.
Возвращаемое значение
ZwPrePrepareComplete возвращает STATUS_SUCCESS, если операция завершится успешно. В противном случае эта подпрограмма может вернуть одно из следующих значений:
Возвращаемый код | Описание |
---|---|
|
Указанный дескриптор не является дескриптором объекта перечисления. |
|
Дескриптор объекта недопустим. |
|
Транзакция или его перечисление не находится в правильном состоянии. |
|
Вызывающий объект не имеет соответствующего доступа к объекту перечисления. |
Подпрограмма может возвращать другие значения NTSTATUS .
Замечания
Диспетчер ресурсов должен вызывать ZwPrePrepareComplete после завершения обслуживания уведомления TRANSACTION_NOTIFY_PREPREPARE.
Дополнительные сведения о ZwPrePrepareCompleteсм. в обработке операций фиксации.
NtPrePrepareComplete и ZwPrePrepareComplet eComplete — это две версии одной подпрограммы системных служб Windows Native.
Для вызовов драйверов в режиме ядра NtXxx и ZwXxx версии подпрограммы Windows Native System Services могут вести себя по-разному в том, как они обрабатывают и интерпретируют входные параметры. Дополнительные сведения о связи между NtXxx и ZwXxx версиями подпрограммы см. в разделе Using Nt and Zw Versions of the Native System Services Routines.
Требования
Требование | Ценность |
---|---|
минимальные поддерживаемые клиентские | Доступно в Windows Vista и более поздних версиях операционной системы. |
целевая платформа | Всеобщий |
заголовка | wdm.h (include Wdm.h, Ntifs.h) |
библиотеки | NtosKrnl.lib |
DLL | NtosKrnl.exe |
IRQL | PASSIVE_LEVEL |
правил соответствия DDI | HwStorPortProhibitedDDIs, PowerIrpDDis |
См. также
использование версий собственных системных служб и Zw