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 |