DosFSAttach

Bindings:  C, MASM 

DosFSAttach attaches or detaches drive to/from a remote FSD, or a 
pseudo-character device name to/from a local or remote FSD. 

 DosFSAttach     (DeviceName, FSDName, DataBuffer, DataBufferLen, OpFlag, 
                 Reserved) 
 

 DeviceName (PSZ) - input 
    Points to either the drive letter followed by a colon, or points to a 
    pseudo-character device name.  If DeviceName is a drive, it is an 
    ASCIIZ string having the form of drive letter followed by a colon.  If 
    an attach is successful, all requests to that drive are routed to the 
    specified FSD.  If a detach is successful, the drive disappears from 
    the system's name space. 

    If DeviceName is a pseudo-character device name (single file device), 
    its format is that of an ASCIIZ string in the format of an OS/2 
    filename in a subdirectory called \DEV\.  All requests to that name 
    are routed to the specified FSD after a successful attach.  A 
    successful detach removes the name from the system's name space. 

 FSDName (PSZ) - input 
    Address of the ASCIIZ name of the remote FSD to attach to or detach 
    from DeviceName. 

 DataBuffer (PBYTE) - input 
    Points to the user-supplied FSD argument data area.  The meaning of 
    the data is specific to the FSD. The DataBuffer contains contiguous 
    ASCIIZ strings, with the first word of the buffer containing the 
    number of ASCIIZ strings. 

 DataBufferLen (USHORT) - input 
    The byte length of the data buffer. 

 OpFlag (USHORT) - input 
    Defines the type of operation to be performed. Attach = 0 and Detach = 
    1. 

 Reserved (ULONG) - input 
    Reserved, must be set to zero. 

 rc (USHORT) - return 
    Return code descriptions are: 

    0         NO_ERROR 
    8         ERROR_NOT_ENOUGH_MEMORY 
    15        ERROR_INVALID_DRIVE 
    124       ERROR_INVALID_LEVEL 
    252       ERROR_INVALID_FSD_NAME 
    253       ERROR_INVALID_PATH 
 
 Remarks 

 The redirection of drive letters representing local drives is not 
 supported. 

 FSDs that wish to establish open connections that are not attached to a 
 name in the system's name space, for such purposes as optimizing UNC 
 connections or establishing access rights, must use an DosFSCtl function 
 to do so.  DosFSAttach only creates attachments to drives or devices in 
 the system's name space. 

 See description of pseudo-character devices.