RxCreateNetFcb-Funktion (fcb.h)

Artikel
02/06/2025

RxCreateNetFCB eine neue FCB-Struktur zuordnet, initialisiert und in die Speicherdatenstrukturen für eine V_NET_ROOT einfügt, auf der 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 das von dieser RX_CONTEXT Struktur gekapselte IRP.

[in] VNetRoot

Ein Zeiger auf die V_NET_ROOT Struktur, auf der 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 einen Zeiger auf eine neu zugeordnete FCB-Datenstruktur zurück, die erfolgreich ist, oder ein NULL Zeiger beim Fehler zurück.

Bemerkungen

Die RxCreateNetFCB Routine wird normalerweise nicht von Netzwerk-Miniumleitungstreibern direkt 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. Dieses IRP wird normalerweise von RDBSS als Reaktion auf eine Benutzermodusanwendung empfangen, die einen Dateierstellungsvorgang auf einer Netzwerkfreigabe anfordert. Es ist auch möglich, dass ein anderer Kerneltreiber ein solches IRP ausgibt.

Wenn es sich bei dem zu erstellenden FCB um eine Auslagerungsdatei handelt, RxCreateNetFCB beim Erstellen der neuen FCB-Datenstruktur nicht ausgelagerten Poolspeicher zuordnet und die folgende Kennzeichnung im FcbState-Mitglied des FCB festlegt:

Wenn der zu erstellende FCB keine Auslagerungsdatei ist, RxCreateNetFCB beim Erstellen der neuen FCB-Datenstruktur seitenseitigen Poolspeicher zuweist.

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

Wenn die Create.Flags Mitglied in der RX_CONTEXT die RX_CONTEXT_CREATE_FLAG_ADDEDBACKSLASH Flagge hat, hat das FcbState Mitglied des FCB das FCB_STATE_ADDEDBACKSLASH Flag festgelegt.