Función NtReadOnlyEnlistment (wdm.h)
El ZwReadOnlyEnlistment rutina establece una inscripción especificada para que sea de solo lectura.
Sintaxis
__kernel_entry NTSYSCALLAPI NTSTATUS NtReadOnlyEnlistment(
[in] HANDLE EnlistmentHandle,
[in, optional] PLARGE_INTEGER TmVirtualClock
);
Parámetros
[in] EnlistmentHandle
Identificador de un objeto de inscripción de obtenido por una llamada anterior a ZwCreateEnlistment o ZwOpenEnlistment. El identificador debe tener ENLISTMENT_SUBORDINATE_RIGHTS acceso al objeto .
[in, optional] TmVirtualClock
Puntero a un valor de reloj virtual . Este parámetro es opcional y se puede NULL.
Valor devuelto
ZwReadOnlyEnlistment devuelve STATUS_SUCCESS si la operación se realiza correctamente. De lo contrario, esta rutina podría devolver uno de los siguientes valores:
| Código devuelto | Descripción |
|---|---|
|
El identificador especificado no es un identificador para un objeto de inscripción. |
|
El identificador de objeto no es válido. |
|
La transacción o su inscripción no está en el estado correcto. Por ejemplo, una inscripción no puede ser de solo lectura si se especificó la marca de ENLISTMENT_SUPERIOR para ZwCreateEnlistment. |
|
El autor de la llamada no tiene el acceso adecuado al objeto de inscripción. |
La rutina puede devolver otros valores NTSTATUS de .
Observaciones
El componente no puede llamar a ZwReadOnlyEnlistment para un de inscripción superior.
Para obtener más información sobre ZwReadOnlyEnlistment, vea Creación de unde inscripción de Read-Only .
NtReadOnlyEnlistment y ZwReadOnlyEnlistment son dos versiones de la misma rutina de Servicios del sistema nativo de Windows.
En el caso de las llamadas desde controladores en modo kernel, las NtXxx y Zwversiones de Xxx de una rutina de Servicios del sistema nativo de Windows pueden comportarse de forma diferente en la forma en que controlan e interpretan los parámetros de entrada. Para obtener más información sobre la relación entre las versiones de NtXxx y ZwXxx de una rutina, vea Using Nt and Zw Versions of the Native System Services Routines.
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Disponible en Windows Vista y versiones posteriores del sistema operativo. |
| de la plataforma de destino de | Universal |
| encabezado de | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |
| biblioteca de | NtosKrnl.lib |
| DLL de | NtosKrnl.exe |
| irQL | PASSIVE_LEVEL |
| reglas de cumplimiento de DDI | HwStorPortProhibitedDIs, PowerIrpDDis |
Consulte también
usar versiones Nt y Zw de las rutinas de servicios del sistema nativo