RxCreateSrvOpen-Funktion (fcb.h)

Artikel
02/06/2025

RxCreateSrvOpen zugeordnet, initialisiert und fügt eine neue SRV_OPEN Struktur in die von RDBSS verwendeten In-Memory-Datenstrukturen ein. Wenn eine neue Struktur zugeordnet werden muss, verfügt sie über Platz für eine FOBX-Struktur.

Syntax

PSRV_OPEN RxCreateSrvOpen(
  [in]      IN PV_NET_ROOT VNetRoot,
  [in, out] IN OUT PFCB    Fcb
);

Parameter

[in] VNetRoot

Ein Zeiger auf die V_NET_ROOT-Struktur.

[in, out] Fcb

Ein Zeiger auf die zugeordnete FCB-Struktur.

Rückgabewert

RxCreateSrvOpen- gibt einen Zeiger auf eine neu erstellte SRV_OPEN Datenstruktur für Erfolg oder einen NULL- Zeiger beim Fehler zurück.

Bemerkungen

Die RxCreateSrvOpen 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 SRV_OPEN 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.

Vor dem Aufrufen RxCreateSrvOpenmuss eine Sperre für die zugeordnete FCB-Struktur im exklusiven Modus erworben werden.

RxCreateSrvOpen versucht und verwendet die SRV_CALL, die als Teil der zugeordneten FCB-Struktur zugeordnet sind, wenn sie verfügbar ist. Wenn der dem FCB zugeordnete SRV_CALL nicht verfügbar ist, weist RxCreateSrvOpen eine neue SRV_CALL Struktur zu.

Wenn es sich bei dem zugeordneten FCB um eine Auslagerungsdatei handelt, werden RxCreateSrvOpen beim Erstellen der neuen SRV_OPEN Datenstruktur nicht ausgelagertem Poolspeicher zugeordnet. Wenn der zugeordnete FCB keine Auslagerungsdatei ist, weist RxCreateSrvOpen beim Erstellen der neuen SRV_OPEN Datenstruktur seitenseitigen Poolspeicher zu.

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