Routine MRxQueryDirectory

Articolo
02/07/2024

La routine MRxQueryDirectory viene chiamata da RDBSS per richiedere che una query mini-redirector di rete su una directory di file.

Sintassi

PMRX_CALLDOWN MRxQueryDirectory;

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

Parametri

RxContext [in, out]
Puntatore alla struttura RX_CONTEXT. Questo parametro contiene l'IRP che richiede l'operazione.

Valore restituito

MRxQueryDirectory restituisce STATUS_SUCCESS sull'esito positivo o su un valore NTSTATUS appropriato, ad esempio uno dei seguenti:

Codice restituito	Descrizione
STATUS_ACCESS_DENIED	Il chiamante non ha la sicurezza appropriata per questa operazione.
STATUS_INSUFFICIENT_RESOURCES	Per completare la query sono state eseguite risorse insufficienti.
STATUS_INVALID_NETWORK_RESPONSE	Un buffer di informazioni sui file non valido è stato ricevuto dal server remoto o da una lunghezza del nome file restituita superata la lunghezza massima consentita.
STATUS_INVALID_PARAMETER	FileInformationClass non valido è stato specificato nel membro Info.FileInformationClass nella struttura RX_CONTEXT a cui fa riferimento il parametro RxContext .
STATUS_LINK_FAILED	Tentativo di riconnessione a un server remoto per completare la query non riuscita.
STATUS_NO_SUCH_FILE	La query non è riuscita a trovare le voci.
STATUS_SHARING_VIOLATION	Si è verificata una violazione della condivisione.

Commenti

Prima di chiamare MRxQueryDirectory, RDBSS modifica i membri seguenti nella struttura RX_CONTEXT a cui punta il parametro RxContext :

Il membro Info.FileInformationClass è impostato su IrpSp-Parameters.QueryDirectory.FileInformationClass>.

Il membro Info.Buffer è impostato sul buffer utente dal pacchetto di richiesta di I/O. Questo buffer è già stato bloccato da RDBSS se necessario.

Il membro Info.LengthRemaining è impostato su IrpSp-Parameters.QueryDirectory.Length>.

Il membro QueryDirectory.FileIndex è impostato su IrpSp-Parameters.QueryDirectory.FileIndex>.

Il membro QueryDirectory.RestartScan è impostato su non zero se IrpSp-Flags> ha il bit di SL_RESTART_SCAN.

Il membro QueryDirectory.ReturnSingleEntry è impostato su non zero se IrpSp-Flags> ha il bit di SL_RETURN_SINGLE_ENTRY.

Il membro QueryDirectory.IndexSpecified è impostato su non zero se IrpSp-Flags> ha il bit di SL_INDEX_SPECIFIED.

Il membro QueryDirectory.InitialQuery è impostato su non zero se il membro UnicodeQueryTemplate.Buffer del foBX associato è NULL e il membro Flags del FOBX non dispone del bit di FOBX_FLAG_MATCH_ALL.

Per una query con caratteri jolly ("*.*", ad esempio), RDBSS imposta il membro UnicodeQueryTemplate.Buffer della query foBX associata alla query con caratteri jolly passata.

Se il membro PostRequest della struttura di RX_CONTEXT è TRUE restituito da MRxQueryDirectory, RDBSS chiamerà RxFsdPostRequest passando la struttura RX_CONTEXT a una coda di lavoro per l'elaborazione dal processo di file system (FSP).