Funzione NtReadOnlyEnlistment (wdm.h)

Articolo
02/07/2025

La routine ZwReadOnlyEnlistment imposta un'integrazione specificata in modo che sia di sola lettura.

Sintassi

__kernel_entry NTSYSCALLAPI NTSTATUS NtReadOnlyEnlistment(
  [in]           HANDLE         EnlistmentHandle,
  [in, optional] PLARGE_INTEGER TmVirtualClock
);

Parametri

[in] EnlistmentHandle

Handle per un oggetto di integrazione ottenuto da una chiamata precedente a ZwCreateEnlistment o ZwOpenEnlistment. L'handle deve avere ENLISTMENT_SUBORDINATE_RIGHTS accesso all'oggetto.

[in, optional] TmVirtualClock

Puntatore a un valore di clock virtuale . Questo parametro è facoltativo e può essere NULL.

Valore restituito

ZwReadOnlyEnlistment restituisce STATUS_SUCCESS se l'operazione ha esito positivo. In caso contrario, questa routine potrebbe restituire uno dei valori seguenti:

Codice restituito	Descrizione
STATUS_OBJECT_TYPE_MISMATCH	L'handle specificato non è un handle per un oggetto di integrazione.
STATUS_INVALID_HANDLE	L'handle dell'oggetto non è valido.
STATUS_TRANSACTION_NOT_REQUESTED	La transazione o il relativo inserimento non è nello stato corretto. Ad esempio, un'integrazione non può essere di sola lettura se il flag di ENLISTMENT_SUPERIOR è stato specificato per ZwCreateEnlistment.
STATUS_ACCESS_DENIED	Il chiamante non dispone dell'accesso appropriato all'oggetto di integrazione.

La routine potrebbe restituire altri valori NTSTATUS .

Osservazioni

Il componente non può chiamare ZwReadOnlyEnlistment per un'integrazione superiore.

Per altre informazioni su ZwReadOnlyEnlistment, vedere Creating a Read-Only Enlistment.

NtReadOnlyEnlistment e ZwReadOnlyEnlistment sono due versioni della stessa routine di Servizi di sistema nativi di Windows.

Per le chiamate da driver in modalità kernel, le NtXxx e ZwXxx versioni di una routine di Windows Native System Services possono comportarsi in modo diverso nel modo in cui gestiscono e interpretano i parametri di input. Per altre informazioni sulla relazione tra le versioni NtXxx e ZwXxx di una routine, vedere Using Nt and Zw Versions of the Native System Services Routines.

Fabbisogno

Requisito	Valore
client minimo supportato	Disponibile in Windows Vista e versioni successive del sistema operativo.
piattaforma di destinazione	Universale
intestazione	wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
libreria	NtosKrnl.lib
dll	NtosKrnl.exe
IRQL	PASSIVE_LEVEL
regole di conformità DDI	HwStorPortProhibitedDDIs, PowerIrpDDis

Vedere anche

uso di versioni Nt e Zw delle routine di Servizi di sistema nativi

ZwCreateEnlistment

ZwOpenEnlistment

Condividi tramite