Funzione NtReadOnlyEnlistment (wdm.h)

  • Articolo

La routine ZwReadOnlyEnlistment imposta un elenco specificato per essere di sola lettura.

Sintassi

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

Parametri

[in] EnlistmentHandle

Handle a un oggetto enlistment 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 orologio 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 enlistment.
STATUS_INVALID_HANDLE
 L'handle dell'oggetto non è valido.
STATUS_TRANSACTION_NOT_REQUESTED
 La transazione o l'inserimento non è nello stato corretto. Ad esempio, un elenco non può essere di sola lettura se il flag di ENLISTMENT_SUPERIOR è stato specificato in ZwCreateEnlistment.
STATUS_ACCESS_DENIED
 Il chiamante non dispone dell'accesso appropriato all'oggetto enlistment.
 

La routine potrebbe restituire altri valori NTSTATUS.

Commenti

Il componente non può chiamare ZwReadOnlyEnlistment per un inserimento superiore.

Per altre informazioni su ZwReadOnlyEnlistment, vedere Creazione di un Read-Only enlistment.

NtReadOnlyEnlistment e ZwReadOnlyEnlistment sono due versioni della stessa routine di Windows Native System Services.

Per le chiamate dai driver in modalità kernel, le versioni NtXxx e ZwXxx 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 Uso di nt e zw versioni delle routine di Servizi di sistema nativo.

Requisiti

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

Vedi anche

Uso di nt e zw versioni delle routine di Servizi di sistema nativo

ZwCreateEnlistment

ZwOpenEnlistment