IFSMgr_UseDel
IFSMgr_UseDel(
pioreq pir,
int proId,
netuse_info *pinfo
)
This service is called by an FSD to perform a network delete use operation to delete a connection to a network resource.
- pir
- Supplies pointer to IOREQ structure. If a NULL is passed in for the IOREQ pointer, the IFS manager allocates an IOREQ structure for the duration of this call. In this case, the caller also needs to pass in the pinfo parameter so that the IOREQ structure can be appropriately initialized. The IOREQ structure is freed before return from the service.
- ir_data
- Supplies the ASCIIZ string the resource to be disconnected is currently connected to viz. a device name or driveletter or UNC name.
- ir_flags
- Supplies the force level to use for the disconnection. There are 4 possible force levels: from 0 through 3. The force level has different semantics based on the type of connection. These are described below. Note that static connections cannot be blasted by any of these force levels. They are disconnected only when the system shuts down.
| UNC Disconnection Force Values: |
|
| Value |
Meaning |
| FORCE LEVEL 0 |
Fails if there are any open files. If there are multiple UNC connections to the same resource, this disconnects only one of them. |
| FORCE LEVEL 1 |
Fails if there are any open files. It blasts all UNC connections to the resource if there are no open files. |
| FORCE LEVEL 2, 3 |
Forces open files closed and then destroys all UNC connections to the resource. Any references to these open files that have been forced closed will be failed by the IFS manager. |
| Drive-based Disconnection Force Values: |
|
| Value |
Meaning |
| FORCE LEVEL 0, 1 |
Fails if there are any open files on the resource or if it is the current drive. |
| FORCE LEVEL 2 |
Force closes open files and then disconnects the drive. The disconnection will be failed on level 2 if the drive to be disconnected is the current drive. |
| FORCE LEVEL 3 |
Force closes open files and disconnects the drive even if it is the current drive. |
| Device-based Disconnection Force Values: |
|
| Value |
Meaning |
| FORCE LEVEL 0, 1 |
Fails if there are any open files. If there are no open files, the device will be disconnected. |
| FORCE LEVEL 2, 3 |
Force closes any open files and then disconnects the device. |
- proId
- Supplies the provider of the provider requesting the disconnect.
- pinfo
- Supplies an optional pointer to a netuse_info structure, this should only be passed in if the provider has no IOREQ available, that is, NULL is passed in on the pir parameter above. The fields that need to be initialized are described below. All other fields should be set to zero.
| Netuse_Info Structure: |
|
| Value |
Meaning |
| nu_data |
Supplies the ASCIIZ string the resource to be disconnected is currently connected to viz. a device name or driveletter or UNC name. |
| nu_level |
Disconnect force level. |
| nu_flags |
Supplies flags for the request. |
| FSD_NETAPI_USEOEM |
Is set if you are passing in OEM strings, otherwise strings are assumed to be ANSI. |
| FSD_NETAPI_USELFN |
This flag specifies that the remote name passed in should be treated as a long name. Otherwise, it is treated as a short name. |
- nu_rsvd
- Must be set to 0xff always.
| ir_error |
Returns 0 if success, errorcode if failure.
Returns 0 if no error, errorcode otherwise.
|