Compartir a través de

Función NtReadOnlyEnlistment (wdm.h)

  • Artículo

La rutina ZwReadOnlyEnlistment establece que una inscripción especificada 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 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 puede ser 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
STATUS_OBJECT_TYPE_MISMATCH
 El identificador especificado no es un identificador para un objeto de inscripción.
STATUS_INVALID_HANDLE
 El identificador de objeto no es válido.
STATUS_TRANSACTION_NOT_REQUESTED
 La transacción o su inscripción no están en el estado correcto. Por ejemplo, una inscripción no puede ser de solo lectura si la marca ENLISTMENT_SUPERIOR se especificó en ZwCreateEnlistment.
STATUS_ACCESS_DENIED
 El autor de la llamada no tiene el acceso adecuado al objeto de inscripción.
 

La rutina podría devolver otros valores NTSTATUS.

Comentarios

El componente no puede llamar a ZwReadOnlyEnlistment para obtener una inscripción superior.

Para obtener más información sobre ZwReadOnlyEnlistment, vea Creating a Read-Only Enlistment.

NtReadOnlyEnlistment y ZwReadOnlyEnlistment son dos versiones de la misma rutina de Windows Native System Services.

En el caso de las llamadas desde controladores en modo kernel, las versiones NtXxx y ZwXxx de una rutina de Windows Native System Services 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 NtXxx y ZwXxx de una rutina, vea Using Nt and Zw Versions of the Native System Services Routines.

Requisitos

Requisito Value
Cliente mínimo compatible Disponible en Windows Vista y versiones posteriores del sistema operativo.
Plataforma de destino Universal
Encabezado wdm.h (incluya Wdm.h, Ntddk.h, Ntifs.h)
Library NtosKrnl.lib
Archivo DLL NtosKrnl.exe
IRQL PASSIVE_LEVEL
Reglas de cumplimiento de DDI HwStorPortProhibitedDIs, PowerIrpDDis

Consulte también

Uso de las versiones Nt y Zw de las rutinas nativas de System Services

ZwCreateEnlistment

ZwOpenEnlistment