RxCreateNetFobx-Funktion (fcb.h)

Artikel
02/06/2025

RxCreateNetFobx eine neue Dateiobjekterweiterung (FILE Object Extension, FOBX) zuordnet, initialisiert und in die Speicherdatenstrukturen eines FCB einfügt, auf dem dieses FOBX geöffnet wird.

Syntax

PMRX_FOBX RxCreateNetFobx(
  [out] OUT PRX_CONTEXT  RxContext,
  [in]  IN PMRX_SRV_OPEN MrxSrvOpen
);

Parameter

[out] RxContext

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

[in] MrxSrvOpen

Ein Zeiger auf die zugeordnete SRV_OPEN Struktur.

Rückgabewert

RxCreateNetFobx- gibt einen Zeiger auf eine neu zugeordnete FOBX-Datenstruktur für Erfolg oder einen NULL- Zeiger beim Fehler zurück.

Bemerkungen

Netzwerkminiumleitungen sollten RxCreateNetFobx- aufrufen, um eine FOBX am Ende eines erfolgreichen Erstellungsvorgangs zu erstellen.

Vor dem Aufrufen RxCreateNetFobxmuss der FCB, der der FOBX-Struktur zugeordnet ist, im exklusiven Modus erworben werden.

RxCreateNetFobx versucht und verwendet die FOBX,die als Teil der zugeordneten FCB-Struktur zugeordnet ist, wenn sie verfügbar ist. Wenn die dem FCB zugeordnete FOBX nicht verfügbar ist, versuchen RxCreateNetFobx , die FOBX als Teil der zugeordneten SRV_OPEN Struktur zu verwenden, wenn sie verfügbar ist. In einem dieser Fälle muss RxCreateNetFobx- nur die vorhandene FOBX-Struktur initialisieren, es ist keine Speicherzuweisung erforderlich. Wenn beide FOBX-Strukturen auf der zugeordneten FCB- und SRV_OPEN-Struktur nicht verfügbar sind, weist RxCreateNetFobx eine neue FOBX-Struktur zu.

Wenn es sich bei dem zugeordneten FCB um eine Auslagerungsdatei handelt, RxCreateNetFobx- beim Erstellen der neuen FOBX-Datenstruktur Speicher zuweist. Wenn es sich bei dem zugeordneten FCB um keine Auslagerungsdatei handelt, RxCreateNetFobx beim Erstellen der neuen FOBX-Datenstruktur seitenseitigen Poolspeicher zuweist.

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

Bei Erfolg werden die folgenden FOBX-Member in der FOBX-Struktur festgelegt:

Das NodeReference Member ist auf 1 festgelegt.
Das FobxSerialNumber Member ist auf 0 festgelegt.
Das SrvOpen Member wird auf die zugeordnete SRV_OPEN Struktur festgelegt.
Das fOpenCountDecremented Member wird auf FALSE-festgelegt.
Das Flags Member wird auf einen Wert festgelegt, der auf Parametern aus dem RX_CONTEXT basiert und ob ein neues FOBX zugeordnet werden muss.

Bei Erfolg wird die Verweisanzahl für die SRV_OPEN-Struktur erhöht, und die NumberOfFobxs Member für die zugeordnete V_NET_ROOT-Struktur wird erhöht.