Funzione RxFinalizeSrvCall (fcb.h)

Articolo
02/06/2025

RxFinalizeSrvCall finalizza la struttura di SRV_CALL specificata. Il chiamante deve avere un blocco esclusivo sulla tabella netname associata all'oggetto dispositivo.

Sintassi

BOOLEAN RxFinalizeSrvCall(
  [out] OUT PSRV_CALL ThisSrvCall,
  [in]  IN BOOLEAN    ForceFinalize
);

Parametri

[out] ThisSrvCall

Puntatore alla struttura SRV_CALL da finalizzare.

[in] ForceFinalize

Valore che indica se la finalizzazione deve essere forzata, indipendentemente dal conteggio dei riferimenti.

Se ForceFinalize è FALSE, il membro NodeReferenceCount della struttura SRV_CALL a cui punta ThisSrvCall deve essere 1 affinché il SRV_CALL venga finalizzato.

Valore restituito

RxFinalizeSrvCall restituisce TRUE in caso di esito positivo o FALSE se la finalizzazione non è stata eseguita:

Osservazioni

La routine RxFinalizeSrvCall non viene normalmente chiamata direttamente dai driver mini-redirector di rete. RDBSS chiama internamente questa routine quando il conteggio dei riferimenti sul SRV_CALL viene decrementato su 1. RDBSS chiama anche RxFinalizeSrvCall quando il driver del mini-redirector di rete viene arrestato o scaricato.

Prima di chiamare RxFinalizeSrvCall, è necessario acquisire in modalità esclusiva un blocco sulla tabella netname associata all'oggetto dispositivo.

Se l'ID del processo in esecuzione corrente è uguale all'ID del processo RDBSS, verrà inviato un thread di lavoro ritardato per eliminare definitivamente la struttura di SRV_CALL. Questo thread di lavoro chiamerà successivamente la routine MRxFinalizeSrvCall fornita dal mini-redirector di rete per finalizzare il SRV_CALL. In caso contrario, la routine di MRxFinalizeSrvCall verrà chiamata direttamente per finalizzare il SRV_CALL.