RxFinalizeNetRoot-Funktion (fcb.h)

Artikel
04/30/2024

RxFinalizeNetRoot schließt die angegebene NET_ROOT-Struktur ab. Der Aufrufer muss über eine exklusive Sperre für die netname-Tabelle verfügen, die dem Geräteobjekt zugeordnet ist.

Syntax

BOOLEAN RxFinalizeNetRoot(
  [out] OUT PNET_ROOT ThisNetRoot,
  [in]  IN BOOLEAN    RecursiveFinalize,
  [in]  IN BOOLEAN    ForceFinalize
);

Parameter

[out] ThisNetRoot

Ein Zeiger auf die NET_ROOT Struktur, die abgeschlossen werden soll.

[in] RecursiveFinalize

Der Wert, der angibt, ob die Finalisierung rekursiv erfolgen soll.

[in] ForceFinalize

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

Wenn ForceFinalizeFALSE ist, muss das NodeReferenceCount-Element der NET_ROOT Struktur, auf die von ThisNetRoot verwiesen wird, 1 sein, damit die NET_ROOT abgeschlossen werden kann.

Rückgabewert

RxFinalizeNetRoot gibt TRUE bei Erfolg oder FALSE zurück, wenn die Finalisierung nicht erfolgt ist: Wenn eine Finalisierung des NET_ROOT bereits in Bearbeitung ist, gibt RxFinalizeNetRootFALSE zurück.

Hinweise

Die RxFinalizeNetRoot-Routine wird normalerweise nicht direkt von Netzwerk-Mini-Redirector-Treibern aufgerufen. RDBSS ruft diese Routine intern auf, wenn die Verweisanzahl auf dem NET_ROOT auf 1 dekrementiert wird.

Vor dem Aufrufen von RxFinalizeNetRoot muss eine Sperre für die dem Geräteobjekt zugeordnete netname-Tabelle im exklusiven Modus abgerufen werden.

Wenn der RekursiveFinalize-ParameterTRUE ist, löscht RxFinalizeNetRoot alle verwaisten FCB-Strukturen, die diesem NET_ROOT zugeordnet sind. Bei diesen verwaisten FCBs handelt es sich um Strukturen, in denen für das FcbState-Mitglied das flag FCB_STATE_ORPHANED festgelegt ist.