INT 2F CU - NETWORK REDIRECTOR - CREATE/TRUNCATE REMOTE FILE
AX = 1117h
ES:DI -> uninitialized SFT
SS = DOS DS
SDA first filename pointer -> fully-qualified name of file to open
SDA CDS pointer -> current directory structure for drive with file
STACK: WORD file creation mode
low byte = file attributes (see #01401 at INT 21/AH=3Ch)
high byte = 00h normal create, 01h create new file
Return: CF set on error
AX = DOS error code (see #01680 at INT 21/AH=59h/BX=0000h)
CF clear if successful
SFT filled (except handle count, which DOS manages itself)
STACK unchanged
Notes: this function is called by the DOS 3.1+ kernel
in MS-DOS, lDOS, and Enhanced DR-DOS the handle count is FFFFh
during this call, marking the SFT as "busy". they all
unconditionally set the count to 0001h after successful open.
MS-DOS v5+ and lDOS will free "busy" SFTs belonging to the
active process (matching process ID and machine ID) during
process termination if the process isn't self-parented and the
termination is not TSR.
MS-DOS v4 and Enhanced DR-DOS will free any SFTs belonging to
the active process (matching process ID and machine ID) during
process termination if the process isn't self-parented and the
termination is not TSR.
FreeDOS seems to pass the SFT with a handle count of 0000h, and
increments it if it is still 0000h after successful open. it
doesn't seem to close SFTs like the MS-DOS v5 "busy" SFTs as
associated with a process (only closing the handles found in
the PHT / Job File Table and SFTs in use for FCBs).
SeeAlso: AX=1106h,AX=1116h,AX=1118h,AX=112Eh,INT 21/AH=3Ch,INT 21/AH=60h