Функция NtSinglePhaseReject (wdm.h)
Подпрограмма ZwSinglePhaseReject информирует KTM о том, что вызывающий диспетчер ресурсов не будет поддерживать однофазные операции фиксации для указанного зачисления.
Синтаксис
__kernel_entry NTSYSCALLAPI NTSTATUS NtSinglePhaseReject(
[in] HANDLE EnlistmentHandle,
[in, optional] PLARGE_INTEGER TmVirtualClock
);
Параметры
[in] EnlistmentHandle
Дескриптор объекта зачисления , который был получен при предыдущем вызове ZwCreateEnlistment или ZwOpenEnlistment. Дескриптор должен иметь ENLISTMENT_SUBORDINATE_RIGHTS доступ к объекту .
[in, optional] TmVirtualClock
Указатель на значение виртуальных часов. Этот параметр является необязательным и может иметь значение NULL.
Возвращаемое значение
ZwSinglePhaseReject возвращает STATUS_SUCCESS, если операция выполнена успешно. В противном случае эта подпрограмма может вернуть одно из следующих значений:
| Код возврата | Описание |
|---|---|
|
Указанный дескриптор не является дескриптором объекта зачисления. |
|
Недопустимый дескриптор объекта. |
|
Транзакция или ее зачисление не находится в правильном состоянии. |
|
Вызывающий объект не имеет соответствующего доступа к объекту зачисления. |
Подпрограмма может возвращать другие значения NTSTATUS.
Комментарии
Диспетчер ресурсов может вызывать ZwSinglePhaseReject при получении уведомления TRANSACTION_NOTIFY_SINGLE_PHASE_COMMIT.
Дополнительные сведения о ZwSinglePhaseReject см. в разделе Обработка операций фиксации.
NtSinglePhaseReject и ZwSinglePhaseReject — это две версии одной и той же подпрограммы системных служб Windows Native. Подпрограмма NtSinglePhaseReject в ядре Windows недоступна напрямую для драйверов режима ядра. Однако драйверы режима ядра могут получить доступ к этой подпрограмме косвенно, вызвав подпрограмму ZwSinglePhaseReject .
Для вызовов из драйверов режима ядра версии NtXxx и ZwXxx подпрограммы Собственные системные службы Windows могут вести себя по-разному, так как они обрабатывают и интерпретируют входные параметры. Дополнительные сведения о связи между версиями подпрограмм NtXxx и ZwXxx см. в разделе Использование версий NT и Zw подпрограмм собственных системных служб.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Доступно в Windows Vista и более поздних версиях операционной системы. |
| Целевая платформа | Универсальное |
| Верхняя часть | wdm.h (включая Wdm.h, Ntddk.h, Ntifs.h) |
| Библиотека | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | PASSIVE_LEVEL |
| Правила соответствия DDI | HwStorPortProhibitedDIs, PowerIrpDDis |