RxCreateNetFobx-Funktion (fcb.h)

Artikel
03/01/2024

RxCreateNetFobx ordnet, initialisiert und fügt eine neue FOBX-Struktur (File Object Extension) in die In-Memory-Datenstrukturen für einen FCB ein, für den diese 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 bei Erfolg oder einen NULL-Zeiger bei Einem Fehler zurück.

Hinweise

Netzwerk-Miniumleitungen sollten RxCreateNetFobx aufrufen, um am Ende eines erfolgreichen Erstellungsvorgangs einen FOBX zu erstellen.

Vor dem Aufrufen von RxCreateNetFobx muss der der FOBX-Struktur zugeordnete FCB im exklusiven Modus abgerufen werden.

RxCreateNetFobx versucht, die FOBX zu verwenden, die als Teil der zugeordneten FCB-Struktur zugeordnet ist, sofern verfügbar. Wenn das mit dem FCB zugeordnete FOBX nicht verfügbar ist, versucht RxCreateNetFobx , den als Teil der zugeordneten SRV_OPEN-Struktur zugeordneten FOBX zu verwenden, sofern verfügbar. In beiden Fällen muss RxCreateNetFobx nur die vorhandene FOBX-Struktur initialisieren, es ist keine Speicherbelegung erforderlich. Wenn beide FOBX-Strukturen für die zugeordnete FCB- und SRV_OPEN-Struktur nicht verfügbar sind, ordnet RxCreateNetFobx eine neue FOBX-Struktur zu.

Wenn es sich bei dem zugeordneten FCB um eine Auslagerungsdatei handelt, weist RxCreateNetFobx beim Erstellen der neuen FOBX-Datenstruktur nicht ausgelagerten Poolspeicher zu. Wenn der zugeordnete FCB keine Auslagerungsdatei ist, weist RxCreateNetFobx beim Erstellen der neuen FOBX-Datenstruktur ausgelagerten Poolspeicher zu.

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

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

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

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