Compartilhar via

Função NtReadOnlyEnlistment (wdm.h)

A rotina ZwReadOnlyEnlistment define uma inscrição especificada como somente leitura.

Sintaxe

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

Parâmetros

[in] EnlistmentHandle

Um identificador de um objeto de inscrição obtido por uma chamada anterior para ZwCreateEnlistment ou ZwOpenEnlistment. O identificador deve ter acesso ENLISTMENT_SUBORDINATE_RIGHTS ao objeto.

[in, optional] TmVirtualClock

Um ponteiro para um valor de relógio virtual . Esse parâmetro é opcional e pode ser NULL.

Valor de retorno

ZwReadOnlyEnlistment retornará STATUS_SUCCESS se a operação for bem-sucedida. Caso contrário, essa rotina poderá retornar um dos seguintes valores:

Código de retorno Descrição
STATUS_OBJECT_TYPE_MISMATCH
 O identificador especificado não é um identificador para um objeto de inscrição.
STATUS_INVALID_HANDLE
 O identificador de objeto é inválido.
STATUS_TRANSACTION_NOT_REQUESTED
 A transação ou sua inscrição não está no estado correto. Por exemplo, uma inscrição não poderá ser somente leitura se o sinalizador ENLISTMENT_SUPERIOR tiver sido especificado para ZwCreateEnlistment .
STATUS_ACCESS_DENIED
 O chamador não tem acesso apropriado ao objeto de inscrição.
 

A rotina pode retornar outros valores NTSTATUS .

Observações

Seu componente não pode chamar ZwReadOnlyEnlistment para um de inscrição superior.

Para obter mais informações sobre ZwReadOnlyEnlistment, consulte Criando umde inscrição Read-Only .

NtReadOnlyEnlistment e ZwReadOnlyEnlistment são duas versões da mesma rotina dos Serviços de Sistema Nativo do Windows.

Para chamadas de drivers no modo kernel, as versões NtXxx e Zwxxx versões de uma rotina dos Serviços de Sistema Nativo do Windows podem se comportar de forma diferente na maneira como lidam e interpretam parâmetros de entrada. Para obter mais informações sobre a relação entre as versões NtXxx e ZwXxx de uma rotina, consulte Usando versões Nt e Zw das rotinas de serviços do sistema nativo.

Requisitos

Requisito Valor
de cliente com suporte mínimo Disponível no Windows Vista e versões posteriores do sistema operacional.
da Plataforma de Destino Universal
cabeçalho wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
biblioteca NtosKrnl.lib
de DLL NtosKrnl.exe
IRQL PASSIVE_LEVEL
regras de conformidade de DDI HwStorPortProhibitedDIs, PowerIrpDDis

Consulte também

usando versões Nt e Zw das rotinas de serviços do sistema nativo

ZwCreateEnlistment

ZwOpenEnlistment

  • Last updated on