RxCreateNetFcb-Funktion (fcb.h)

Artikel
02/29/2024

RxCreateNetFCB weist eine neue FCB-Struktur zu, initialisiert und fügt sie in die In-Memory-Datenstrukturen für eine V_NET_ROOT ein, für die dieser FCB geöffnet wird. Die zugeordnete Struktur verfügt über Platz für eine SRV_OPEN- und eine FOBX-Struktur.

Syntax

PFCB RxCreateNetFcb(
  [in] IN PRX_CONTEXT     RxContext,
  [in] IN PIRP            Irp,
  [in] IN PV_NET_ROOT     VNetRoot,
  [in] IN PUNICODE_STRING Name
);

Parameter

[in] RxContext

Ein Zeiger auf die RX_CONTEXT Struktur, die einen Erstellungsvorgang beschreibt.

[in] Irp

Ein Zeiger auf die von dieser RX_CONTEXT Struktur gekapselte IRP.

[in] VNetRoot

Ein Zeiger auf die V_NET_ROOT Struktur, für die dieser FCB geöffnet wird.

[in] Name

Der Name des FCB. Die V_NET_ROOT kann ein Namenspräfix enthalten, das hier vorangestellt werden soll.

Rückgabewert

RxCreateNetFCB gibt einen Zeiger auf eine neu zugeordnete FCB-Datenstruktur bei Erfolg oder einen NULL-Zeiger bei Fehler zurück.

Hinweise

Die RxCreateNetFCB-Routine wird normalerweise nicht direkt von Netzwerk-Miniumleitungstreibern aufgerufen. RDBSS ruft diese Routine intern auf, wenn ein E/A-Anforderungspaket für IRP_MJ_CREATE empfangen wird und eine FCB-Struktur erstellt werden muss. Diese IRP wird normalerweise von RDBSS als Reaktion auf eine Benutzermodusanwendung empfangen, die einen Dateierstellungsvorgang für eine Netzwerkfreigabe anfordert. Es ist auch möglich, dass ein anderer Kerneltreiber eine solche IRP ausgibt.

Wenn es sich bei dem zu erstellenden FCB um eine Auslagerungsdatei handelt, weist RxCreateNetFCB beim Erstellen der neuen FCB-Datenstruktur nicht ausgelagerten Poolspeicher zu und legt das folgende Flag im FcbState-Mitglied des FCB fest:

Wenn es sich bei dem zu erstellenden FCB um keine Auslagerungsdatei handelt, weist RxCreateNetFCB beim Erstellen der neuen FCB-Datenstruktur ausgelagerten Poolspeicher zu.

Windows lässt derzeit keine Auslagerungsdatei auf einem Remotecomputer zu.

Wenn für das Create.Flags-Mitglied im RX_CONTEXT das Flag RX_CONTEXT_CREATE_FLAG_ADDEDBACKSLASH aktiviert ist, hat das FcbState-Mitglied des FCB das FCB_STATE_ADDEDBACKSLASH-Flag aktiviert.