RxpDereferenceNetFcb-Funktion (fcb.h)
RxpDereferenceNetFcb erhöht die Referenzanzahl einer FCB-Struktur.
Syntax
LONG RxpDereferenceNetFcb(
PFCB Fcb
);
Parameter
Fcb
Ein Zeiger auf die FCB-Struktur, die abgeleitet werden soll.
Rückgabewert
RxpDereferenceNetFcb gibt die letzte Referenzanzahl nach der Ableitung zurück.
Bemerkungen
Die Referenzierung und Ableitung von FCBs unterscheidet sich von denen der anderen Datenstrukturen aufgrund der eingebetteten Ressource im FCB. Dies bedeutet, dass der Anrufer Informationen zum Status des FCB benötigt (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 Ableitung von FCBs. Folglich versucht RxpDereferenceNetFcb nicht, den FCB abzuschließen.
Eine Reihe von Makros werden in fcb.h 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 Makros ist die bevorzugte Methode, 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 RxpDereferenceNetFcb bewirkt, dass das System ASSERTION ausführt, wenn der Knotentyp für die Struktur kein FCB ist oder die endgültige Referenzanzahl kleiner als 0 ist.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform- | Desktop |
| Header- | fcb.h (enthalten Fcb.h) |
| IRQL- | <= APC_LEVEL |