RxCreateNetFobx-Funktion (fcb.h)
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.
Anforderungen
Anforderung | Wert |
---|---|
Zielplattform- | Desktop |
Header- | fcb.h (enthalten Rxcontx.h, Mrxfcb.h, Fcb.h) |
IRQL- | <= APC_LEVEL |