Freigeben über


RxpDereferenceNetFcb-Funktion (fcb.h)

RxpDereferenceNetFcb verringert die Verweisanzahl für eine FCB-Struktur.

Syntax

LONG RxpDereferenceNetFcb(
  PFCB Fcb
);

Parameter

Fcb

Ein Zeiger auf die FCB-Struktur, die abgeleitet werden soll.

Rückgabewert

RxpDereferenceNetFcb gibt die endgültige Verweisanzahl nach dem Rückschluss zurück.

Hinweise

Die Referenzierung und Dereferencing von FCBs unterscheidet sich von denen der anderen Datenstrukturen aufgrund der eingebetteten Ressource im FCB. Dies bedeutet, dass der Aufrufer Informationen über die status des FCB benötigt (unabhängig davon, ob er abgeschlossen wurde oder nicht). Um den FCB abzuschließen, müssen zwei Sperren gehalten werden, die NET_ROOT Namenstabellensperre sowie die FCB-Ressource. Diese Überlegungen führen zu einem anderen Ansatz bei der Deferencierung von FCBs. Daher versucht RxpDereferenceNetFcb nicht, den FCB abzuschließen.

In fcb.h werden eine Reihe von Makros für das Debuggen definiert, die die bevorzugte Methode zum Aufrufen dieser Routine sind. Diese Makros stellen einen Wrapper um die RxpReferenceNetFcb - oder RxpDereferenceNetFcb-Routinen bereit, die für Dateistrukturverwaltungsvorgänge in FCB-Strukturen verwendet werden. Das RxDereferenceNetFcb-Makro ist die bevorzugte Möglichkeit, diese Routine aufzurufen. Dieses Makro ruft zuerst die RxpTrackDereference-Routine auf, um Diagnoseinformationen zur Anforderung zu protokollieren, bevor die RxpDereferenceNetFcb-Routine aufgerufen wird .

Bei überprüften Builds bewirkt RxpDereferenceNetFcb , dass das System ASSERT ausführt, wenn der Knotentyp für die Struktur kein FCB ist oder wenn die endgültige Referenzanzahl kleiner als 0 ist.

Anforderungen

Anforderung Wert
Zielplattform Desktop
Kopfzeile fcb.h (einschließlich Fcb.h)
IRQL <= APC_LEVEL

Weitere Informationen

RxpReferenceNetFcb

RxpTrackDereference

RxpTrackReference

Die FCB-Struktur