Bewerken

Delen via


PMRX_FINALIZE_SRVCALL_CALLDOWN callback function (mrx.h)

The MRxFinalizeSrvCall routine is called by RDBSS to request that a network mini-redirector finalize an SRV_CALL structure.

Syntax

PMRX_FINALIZE_SRVCALL_CALLDOWN PmrxFinalizeSrvcallCalldown;

NTSTATUS PmrxFinalizeSrvcallCalldown(
  IN OUT PMRX_SRV_CALL SrvCall,
  IN BOOLEAN Force
)
{...}

Parameters

SrvCall

[in, out] A pointer to the SRV_CALL structure to finalize.

Force

[in] A pointer to a Boolean value that indicates if the disconnect is to be enforced immediately, ignoring the reference count on the SRV_CALL structure. The Force parameter is the ForceFinalize parameter passed to the RxFinalizeSrvCall routine. This action triggers a call to MRxFinalizeSrvCall.

Return value

MRxFinalizeSrvCall returns STATUS_SUCCESS on success.

Remarks

MRxFinalizeSrvCall is called when RDBSS is tearing down an SRV_CALL structure. The network mini-redirector is expected to close its connection to the server.

MRxFinalizeSrvCall is called by RDBSS after receiving an RxFinalizeSrvCall call. If RxFinalizeSrvCall is called from a different process than the RDBSS system process, then the call to MRxFinalizeSrvCall is posted to a worker thread for later execution. At some later time RxFinalizeSrvCall is called to complete the finalization of the SRV_CALL structure.

RDBSS ignores the return value from the MRxFinalizeSrvCall call.

Requirements

Requirement Value
Target Platform Desktop
Header mrx.h (include Mrx.h)

See also

MRxCreateSrvCall

MRxCreateVNetRoot

MRxExtractNetRootName

MRxFinalizeNetRoot

MRxFinalizeVNetRoot

MRxPreparseName

MRxSrvCallWinnerNotify

RxFinalizeSrvCall