função de retorno de chamada PMRX_IS_LOCK_REALIZABLE (mrx.h)

Artigo
10/13/2023

A rotina MRxIsLockRealizable é chamada pelo RDBSS para solicitar que um minidiretório de rede indique se há suporte para um bloqueio de intervalo de bytes específico nessa estrutura de NET_ROOT.

Sintaxe

PMRX_IS_LOCK_REALIZABLE PmrxIsLockRealizable;

NTSTATUS PmrxIsLockRealizable(
  IN OUT PMRX_FCB Fcb,
  IN PLARGE_INTEGER ByteOffset,
  IN PLARGE_INTEGER Length,
  IN ULONG LowIoLockFlags
)
{...}

Parâmetros

Fcb

[in, out] Um ponteiro para a estrutura FCB.

ByteOffset

[in] Um valor que indica o deslocamento de bytes para o bloqueio de intervalo de bytes.

Length

[in] Um valor que indica o comprimento do bloqueio de intervalo de bytes.

LowIoLockFlags

[in] Um valor com uma máscara de bits que indica os sinalizadores de bloqueio de E/S.

Retornar valor

MRxIsLockRealizable retorna STATUS_SUCCESS com êxito ou um valor NTSTATUS apropriado, como o seguinte:

Código de retorno	Descrição
STATUS_NOT_SUPPORTED	Não há suporte para o bloqueio de intervalo de bytes solicitado. Um minidiretório de rede retornaria esse valor para uma solicitação de bloqueio sem suporte, mesmo que outros tipos de bloqueios de intervalo de bytes sejam compatíveis. Bloqueios sem suporte podem incluir bloqueios de 64 bits (o membro ByteOffset-HighPart> não é zero), bloqueios de comprimento zero (o parâmetro Length é zero) ou bloqueios compartilhados (o bit LOWIO_LOCKSFLAG_EXCLUSIVELOCK do parâmetro LowIoLockFlags não está definido).

Código de retorno

Descrição

STATUS_NOT_SUPPORTED

Não há suporte para o bloqueio de intervalo de bytes solicitado. Um minidiretório de rede retornaria esse valor para uma solicitação de bloqueio sem suporte, mesmo que outros tipos de bloqueios de intervalo de bytes sejam compatíveis. Bloqueios sem suporte podem incluir bloqueios de 64 bits (o membro ByteOffset-HighPart> não é zero), bloqueios de comprimento zero (o parâmetro Length é zero) ou bloqueios compartilhados (o bit LOWIO_LOCKSFLAG_EXCLUSIVELOCK do parâmetro LowIoLockFlags não está definido).

Comentários

MRxIsLockRealizable determina se o bloqueio de intervalo de bytes específico solicitado tem suporte nessa estrutura de NET_ROOT. Um minidiretório de rede pode dar suporte a determinados bloqueios de intervalo de bytes e não dar suporte a outros. Por exemplo, um minidiretório de rede pode dar suporte apenas a bloqueios de intervalo de bytes de 32 bits ou bloqueios exclusivos.

MRxIsLockRealizable é chamado em resposta ao recebimento de um IRP com a função secundária IRP_MN_LOCK.