MRxQueryDirectory-Routine

Artikel
02/07/2024

Die MRxQueryDirectory-Routine wird von RDBSS aufgerufen, um anzufordern, dass eine Netzwerk-Miniumleitung Informationen zu einem Dateiverzeichnis abfragt.

Syntax

PMRX_CALLDOWN MRxQueryDirectory;

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

Parameter

RxContext [in, out]
Ein Zeiger auf die RX_CONTEXT-Struktur. Dieser Parameter enthält das IRP, das den Vorgang anfordert.

Rückgabewert

MRxQueryDirectory gibt STATUS_SUCCESS nach Erfolg oder einen geeigneten NTSTATUS-Wert zurück, z. B. einen der folgenden:

Rückgabecode	Beschreibung
STATUS_ACCESS_DENIED	Dem Aufrufer fehlte die richtige Sicherheit für diesen Vorgang.
STATUS_INSUFFICIENT_RESOURCES	Es gab nicht genügend Ressourcen, um die Abfrage abzuschließen.
STATUS_INVALID_NETWORK_RESPONSE	Vom Remoteserver wurde ein ungültiger Dateiinformationspuffer empfangen, oder eine zurückgegebene Dateinamenlänge überschreitet die maximal zulässige Länge.
STATUS_INVALID_PARAMETER	Eine ungültige FileInformationClass wurde im Info.FileInformationClass-Member in der RX_CONTEXT-Struktur angegeben, auf die der RxContext-Parameter verweist.
STATUS_LINK_FAILED	Fehler beim Versuch, erneut eine Verbindung mit einem Remoteserver herzustellen, um die Abfrage abzuschließen.
STATUS_NO_SUCH_FILE	Die Abfrage konnte keine Einträge finden.
STATUS_SHARING_VIOLATION	Ein Verstoß gegen die Freigabe ist aufgetreten.

Hinweise

Vor dem Aufruf von MRxQueryDirectory ändert RDBSS die folgenden Member in der RX_CONTEXT-Struktur, auf die der RxContext-Parameter verweist:

Das Info.FileInformationClass-Element ist auf IrpSp-Parameters.QueryDirectory.FileInformationClass> festgelegt.

Das Info.Buffer-Element ist auf benutzerpuffer aus E/A-Anforderungspaket festgelegt. Dieser Puffer wurde bei Bedarf bereits von RDBSS gesperrt.

Das Info.LengthRemaining-Element ist auf IrpSp-Parameters.QueryDirectory.Length> festgelegt.

Das QueryDirectory.FileIndex-Element ist auf IrpSp-Parameters.QueryDirectory.FileIndex> festgelegt.

Das QueryDirectory.RestartScan-Element wird auf ungleich null festgelegt, wenn IrpSp-Flags> das SL_RESTART_SCAN Bit aktiviert hat.

Das QueryDirectory.ReturnSingleEntry-Element ist auf ungleich null festgelegt, wenn IrpSp-Flags> das SL_RETURN_SINGLE_ENTRY Bit aktiviert hat.

Das QueryDirectory.IndexSpecified-Element wird auf ungleich null festgelegt, wenn IrpSp-Flags> das SL_INDEX_SPECIFIED Bit aktiviert hat.

Das QueryDirectory.InitialQuery-Element wird auf ungleich null festgelegt, wenn der UnicodeQueryTemplate.Buffer-Member des zugeordneten FOBX-Elements NULL ist und das Flags-Element des FOBX nicht das FOBX_FLAG_MATCH_ALL Bit aktiviert hat.

Für eine wild Karte Abfrage ("*.*", z. B.), legt RDBSS den UnicodeQueryTemplate.Buffer-Member des zugeordneten FOBX auf die wild Karte übergebenen Abfrage fest.

Wenn der PostRequest-Member der RX_CONTEXT-Struktur bei der Rückgabe von MRxQueryDirectoryTRUE ist, ruft RDBSS RxFsdPostRequest auf und übergibt die RX_CONTEXT-Struktur an eine Workerwarteschlange zur Verarbeitung durch den Dateisystemprozess (File System Process, FSP).