Kommentar
Åtkomst till den här sidan kräver auktorisering. Du kan prova att logga in eller ändra kataloger.
Åtkomst till den här sidan kräver auktorisering. Du kan prova att ändra kataloger.
RxFinalizeConnection deletes a connection to a share. Any files open on the connection are closed depending on the level of force specified. The network mini-redirector might choose to keep the transport connection open for performance reasons, unless some option is specified to force a close of connection.
Syntax
NTSTATUS RxFinalizeConnection(
IN OUT PNET_ROOT NetRoot,
IN OUT PV_NET_ROOT VNetRoot,
IN LOGICAL ForceFilesClosed
);
Parameters
NetRoot
[in, out] A pointer to the NET_ROOT structure being finalized.
VNetRoot
A pointer to the V_NET_ROOT structure being finalized.
ForceFilesClosed
The flag that controls the behavior of the RxFinalizeConnection routine. The flag can be one of the following values:
- TRUE
- FALSE
- 0xff
RxFinalizeConnection succeeds no matter what even if orphan files and IRP_MN_NOTIFY_CHANGE_DIRECTORY requests are open. The option forces these orphan files closed.
RxFinalizeConnection fails if files or change notifications are open.
RxFinalizeConnection removes the extra reference on the V_NET_ROOT structure due to the add connection request, but otherwise act like FALSE. RxFinalizeConnection fails if files or change notifications are open.
Return value
RxFinalizeConnection returns STATUS_SUCCESS on success or one of the following error codes on failure:
| Return code | Description |
|---|---|
|
The Flags member of the RX_CONTEXT structure indicates the IRP was canceled. |
|
The connection is still in use. |
|
The file was open, so the remote connection should not be deleted. |
|
An exclusive lock on the associated |
Remarks
RxFinalizeConnection is normally called by a network mini-redirector driver in response to receiving a custom IOCTL request from user mode. For example, a user might execute from the command line a "NET USE x: /d" to delete a share. This request would be mapped through the network provider DLL provided by the network mini-redirector to a custom IOCTL request sent to the network mini-redirector kernel driver which would call the RxFinalizeConnection routine to delete the connection.
RxFinalizeConnection cancels all the outstanding requests for a given V_NET_ROOT structure. These V_NET_ROOT structures are created and deleted independent of the files that are opened and manipulated on them. Therefore it is imperative that when a delete operation is attempted, all the outstanding requests are canceled.
Requirements
| Requirement | Value |
|---|---|
| Target Platform | Desktop |
| Header | rxprocs.h (include Rxprocs.h) |
| IRQL | <= APC_LEVEL |