Rotina MRxQueryDirectory

Artigo
02/02/2024

A rotina MRxQueryDirectory é chamada pelo RDBSS para solicitar que uma consulta de minidiretório de rede em um diretório de arquivos.

Sintaxe

PMRX_CALLDOWN MRxQueryDirectory;

NTSTATUS MRxQueryDirectory(
  _Inout_ PRX_CONTEXT RxContext
)
{ ... }

Parâmetros

RxContext [in, out]
Um ponteiro para a estrutura RX_CONTEXT. Esse parâmetro contém o IRP que está solicitando a operação.

Retornar valor

MRxQueryDirectory retorna STATUS_SUCCESS com êxito ou um valor NTSTATUS apropriado, como um dos seguintes:

Código de retorno	Descrição
STATUS_ACCESS_DENIED	O chamador não tinha a segurança adequada para esta operação.
STATUS_INSUFFICIENT_RESOURCES	Não havia recursos suficientes para concluir a consulta.
STATUS_INVALID_NETWORK_RESPONSE	Um buffer de informações de arquivo inválido foi recebido do servidor remoto ou um comprimento de nome de arquivo retornado excedeu o comprimento máximo permitido.
STATUS_INVALID_PARAMETER	Um FileInformationClass inválido foi especificado no membro Info.FileInformationClass na estrutura RX_CONTEXT apontada pelo parâmetro RxContext .
STATUS_LINK_FAILED	Falha na tentativa de reconectar-se a um servidor remoto para concluir a consulta.
STATUS_NO_SUCH_FILE	A consulta não conseguiu localizar nenhuma entrada.
STATUS_SHARING_VIOLATION	Ocorreu uma violação de compartilhamento.

Comentários

Antes de chamar MRxQueryDirectory, o RDBSS modifica os seguintes membros na estrutura RX_CONTEXT apontada pelo parâmetro RxContext :

O membro Info.FileInformationClass é definido como IrpSp-Parameters.QueryDirectory.FileInformationClass>.

O membro Info.Buffer é definido como buffer de usuário do pacote de solicitação de E/S. Esse buffer já foi bloqueado pelo RDBSS, se necessário.

O membro Info.LengthRemaining é definido como IrpSp-Parameters.QueryDirectory.Length>.

O membro QueryDirectory.FileIndex está definido como IrpSp-Parameters.QueryDirectory.FileIndex>.

O membro QueryDirectory.RestartScan será definido como diferente de zero se IrpSp-Flags> tiver o SL_RESTART_SCAN bit ativado.

O membro QueryDirectory.ReturnSingleEntry será definido como diferente de zero se IrpSp-Flags> tiver o SL_RETURN_SINGLE_ENTRY bit ativado.

O membro QueryDirectory.IndexSpecified será definido como diferente de zero se IrpSp-Flags> tiver o SL_INDEX_SPECIFIED bit ativado.

O membro QueryDirectory.InitialQuery será definido como diferente de zero se UnicodeQueryTemplate.Buffer membro do FOBX associado for NULL e o membro Flags do FOBX não tiver o FOBX_FLAG_MATCH_ALL bit ativado.

Para uma consulta de cartão selvagem ("*.*", por exemplo), o RDBSS definirá o membro UnicodeQueryTemplate.Buffer do FOBX associado para a consulta de cartão selvagem passada.

Se o membro PostRequest da estrutura RX_CONTEXT for TRUE no retorno de MRxQueryDirectory, o RDBSS chamará RxFsdPostRequest passando a estrutura RX_CONTEXT para uma fila de trabalho para processamento pelo FSP (processo do sistema de arquivos).