RxFinalizeNetRoot 함수(fcb.h)

아티클
02/26/2024

RxFinalizeNetRoot 는 지정된 NET_ROOT 구조를 완료합니다. 호출자는 디바이스 개체와 연결된 netname 테이블에 대한 배타적 잠금이 있어야 합니다.

구문

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

매개 변수

[out] ThisNetRoot

완료할 NET_ROOT 구조체에 대한 포인터입니다.

[in] RecursiveFinalize

재귀적으로 완료해야 하는지 여부를 나타내는 값입니다.

[in] ForceFinalize

참조 수에 관계없이 종료를 강제 적용해야 하는지 여부를 나타내는 값입니다.

ForceFinalize가 FALSE이면 thisNetRoot가 가리키는 NET_ROOT 구조체의 NodeReferenceCount 멤버가 1이어야 NET_ROOT 완료됩니다.

반환 값

RxFinalizeNetRoot 는 성공 시 TRUE 를 반환하고, 완료되지 않은 경우 FALSE 를 반환합니다. NET_ROOT 완료가 이미 진행 중인 경우 RxFinalizeNetRoot 는 FALSE를 반환합니다.

설명

RxFinalizeNetRoot 루틴은 일반적으로 네트워크 미니 리다이렉터 드라이버에서 직접 호출되지 않습니다. RDBSS는 NET_ROOT 대한 참조 수가 1로 감소할 때 내부적으로 이 루틴을 호출합니다.

RxFinalizeNetRoot를 호출하기 전에 디바이스 개체와 연결된 netname 테이블에 대한 잠금을 배타적 모드로 획득해야 합니다.

RecursiveFinalize 매개 변수가 TRUE이면 RxFinalizeNetRoot는 이 NET_ROOT 연결된 분리된 FCB 구조를 모두 제거합니다. 이러한 ophaned FCB는 FcbState 멤버에 FCB_STATE_ORPHANED 플래그가 설정된 구조체입니다.