RxFinalizeNetFobx-Funktion (fcb.h)

Artikel
02/29/2024

RxFinalizeNetFOBX schließt die angegebene FOBX-Struktur ab. Der Aufrufer muss über eine exklusive Sperre für den FCB verfügen, der der FOBX-Struktur zugeordnet ist.

Syntax

BOOLEAN RxFinalizeNetFobx(
  [out] OUT PFOBX  ThisFobx,
  [in]  IN BOOLEAN RecursiveFinalize,
  [in]  IN BOOLEAN ForceFinalize
);

Parameter

[out] ThisFobx

Ein Zeiger auf die zu finalisierende FOBX-Struktur.

[in] RecursiveFinalize

Der Wert, der angibt, ob die Finalisierung rekursiv durchgeführt werden soll. Dieser Parameter wird derzeit nicht verwendet.

[in] ForceFinalize

Der Wert, der angibt, ob die Finalisierung erzwungen werden soll, unabhängig von der Verweisanzahl.

Wenn ForceFinalizeauf FALSE festgelegt ist, muss das NodeReferenceCount-Element der FOBX-Struktur, auf die von ThisFobx verwiesen wird, 0 sein, damit foBX abgeschlossen werden kann.

Rückgabewert

RxFinalizeNetFOBX gibt BEI Erfolg TRUE oder FALSE zurück, wenn die Finalisierung nicht erfolgt ist:

Hinweise

Die RxFinalizeNetFOBX-Routine wird normalerweise nicht direkt von Netzwerk-Mini-Redirector-Treibern aufgerufen. RDBSS ruft diese Routine intern auf, wenn ein E/A-Anforderungspaket für IRP_MJ_CLOSE empfangen wird. Dieser IRP wird normalerweise von RDBSS als Reaktion darauf empfangen, dass eine Anwendung im Benutzermodus einen Vorgang zum Schließen der Datei anfordert. Es ist auch möglich, dass ein anderer Kerneltreiber eine solche IRP ausgibt.

Vor dem Aufrufen von RxFinalizeNetFOBX muss eine Sperre für die FCB-Struktur im exklusiven Modus erworben werden.

Die RxFinalizeNetFOBX-Routine ruft die vom Netzwerk-Mini-Redirector bereitgestellte MRxDeallocateForFobx-Routine auf, um den Arbeitsspeicher für fobx freizugeben, wenn der Netzwerk-Mini-Redirector diese Routine unterstützt.