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