📄 interrup.h
字号:
Interrupt List, part 8 of 18
Copyright (c) 1989,1990,1991,1992,1993,1994,1995,1996,1997,1998,1999 Ralf Brown
--------D-215F00-----------------------------
INT 21 - DOS 3.1+ network - GET REDIRECTION MODE
AX = 5F00h
BL = redirection type
03h printer
04h disk drive
Return: CF set on error
AX = error code (see #01680 at AH=59h/BX=0000h)
CF clear if successful
BH = redirection state
00h off
01h on
Note: calls INT 2F/AX=111Eh with AX on top of the stack
SeeAlso: AX=5F01h,INT 2F/AX=111Eh
--------D-215F01-----------------------------
INT 21 - DOS 3.1+ network - SET REDIRECTION MODE
AX = 5F01h
BL = redirection type
03h printer
04h disk drive
BH = redirection state
00h off
01h on
Return: CF set on error
AX = error code (see #01680 at AH=59h/BX=0000h)
CF clear if successful
Notes: when redirection is off, the local device (if any) rather than the
remote device is used
calls INT 2F/AX=111Eh with AX on top of the stack
SeeAlso: AX=5F00h,INT 2F/AX=111Eh,INT 60/AX=0002h
--------D-215F02-----------------------------
INT 21 - DOS 3.1+ network - GET REDIRECTION LIST ENTRY
AX = 5F02h
BX = zero-based redirection list index
CX = driver signature
0000h LANtastic
4E57h ('NW') NetWare
DS:SI -> 16-byte buffer for ASCIZ local device name or drive letter
followed by colon
ES:DI -> 128-byte buffer for ASCIZ network name
Return: CF clear if successful
BH = device status
00h valid
01h invalid
02h valid (connected from inside Windows for Workgroups v3.11)
BL = device type
03h printer
04h disk drive
CX = user data previously set with AX=5F03h
DS:SI and ES:DI buffers filled
DX,BP destroyed
CF set on error
AX = error code (01h,12h) (see #01680 at AH=59h/BX=0000h)
Notes: this function is passed through to INT 2F/AX=111Eh by the DOS kernel
error code 12h is returned if BX is greater than the size of the list
also supported by Banyan VINES, PC-NFS, LANtastic, and 10NET
supported by LapLink RemoteAccess but returns the local drive letter;
the remote drive letter can be obtained with INT 2F/AX=Cxxxh
(see INT 2F/AX=C000h"LapLink")
the returned device name may or may not include a colon, depending on
the network software
SeeAlso: AX=5F03h,AX=5F46h,INT 2F/AX=111Eh,INT 2F/AX=C000h"LapLink"
--------D-215F03-----------------------------
INT 21 - DOS 3.1+ network - REDIRECT DEVICE
AX = 5F03h
BL = device type
03h printer
04h disk drive
CX = user data to save
0000h for LANtastic
4E57h ("NW") for NetWare 4.0 requester
DS:SI -> ASCIZ local device name (16 bytes max)
ES:DI -> ASCIZ network name + ASCIZ password (128 bytes max total)
Return: CF clear if successful
CF set on error
AX = error code (01h,03h,05h,08h,0Fh,12h) (see #01680 at AH=59h)
Notes: if device type is disk drive, DS:SI must point at either a null string
or a string consisting the drive letter followed by a colon; if a
null string, the network attempts to access the destination without
redirecting a local drive
the DOS kernel calls INT 2F/AX=111Eh with AX on top of the stack
also supported by Banyan VINES, LANtastic, and 10NET
SeeAlso: AX=5F02h,AX=5F04h,INT 2F/AX=111Eh,INT 60/AX=0002h
--------D-215F04-----------------------------
INT 21 - DOS 3.1+ network - CANCEL REDIRECTION
AX = 5F04h
DS:SI -> ASCIZ local device name or path
CX = 4E57h ("NW") for NetWare 4.0 requester
Return: CF clear if successful
CF set on error
AX = error code (01h,03h,05h,08h,0Fh,12h) (see #01680 at AH=59h)
Notes: the DS:SI string must be either a local device name, a drive letter
followed by a colon, or a network directory beginning with two
backslashes
the DOS kernel calls INT 2F/AX=111Eh with AX on top of the stack
also supported by Banyan VINES, LANtastic, and 10NET
for NetWare, if only a server name is specified (i.e. "\\SERVER"),
the connection to that server will be closed
SeeAlso: AX=5F03h,INT 2F/AX=111Eh,INT 60/AX=0003h
--------D-215F05-----------------------------
INT 21 - DOS 4.0+ network - GET EXTENDED REDIRECTION LIST ENTRY
AX = 5F05h
BX = redirection list index
DS:SI -> buffer for ASCIZ source device name
ES:DI -> buffer for destination ASCIZ network path
Return: CF set on error
AX = error code (see #01680 at AH=59h/BX=0000h)
CF clear if successful
AX = server's network process ID handle (10NET)
BH = device status flag (bit 0 clear if valid)
BL = device type (03h if printer, 04h if drive)
CX = stored parameter value (user data) from AX=5F03h
BP = NETBIOS local session number
DS:SI buffer filled
ES:DI buffer filled
Notes: the local session number allows sharing the redirector's session number
if an error is caused on the NETBIOS LSN, the redirector may be unable
to correctly recover from errors
the DOS kernel calls INT 2F/AX=111Eh with AX on top of the stack
supported by DR DOS 5.0
also supported by 10NET v5.0
SeeAlso: AX=5F06h"Network",INT 2F/AX=111Eh
--------O-215F05-----------------------------
INT 21 - STARLITE architecture - MAP LOCAL DRIVE LETTER TO REMOTE FILE SYSTEM
AX = 5F05h
DL = drive number (0=A:)
DS:SI -> ASCIZ name of the object to map the drive to
Return: CF set on error
AX = error code (see #01680 at AH=59h/BX=0000h)
CF clear if successful
SeeAlso: AX=5F06h"STARLITE",INT 60/AX=0002h
--------N-215F06-----------------------------
INT 21 U - Network - GET FULL REDIRECTION LIST
AX = 5F06h
???
Return: ???
Notes: similar to AX=5F02h and AX=5F05h, but also returns redirections
excluded from those calls for various reasons
calls INT 2F/AX=111Eh with AX on top of the stack
SeeAlso: AX=5F05h"DOS",INT 2F/AX=111Eh
--------O-215F06-----------------------------
INT 21 - STARLITE architecture - UNMAP DRIVE LETTER
AX = 5F06h
DL = drive to be unmapped (0=A:)
Return: CF set on error
AX = error code (see #01680 at AH=59h/BX=0000h)
CF clear if successful
SeeAlso: AX=5F05h"STARLITE",INT 60/AX=0003h
--------D-215F07-----------------------------
INT 21 - DOS 5+ - ENABLE DRIVE
AX = 5F07h
DL = drive number (0=A:)
Return: CF clear if successful
CF set on error
AX = error code (0Fh) (see #01680 at AH=59h/BX=0000h)
Notes: simply sets the "valid" bit in the drive's CDS
this function is not supported by Novell DOS 7 through at least
Update 4, but support was added by Update 13
SeeAlso: AH=52h,AX=5F08h"DOS"
--------O-215F07-----------------------------
INT 21 - STARLITE architecture - MAKE NAMED OBJECT AVAILABLE ON NETWORK
AX = 5F07h
DS:SI -> ASCIZ name of object to offer to network
ES:DI -> ASCIZ name under which object will be known on the network
MUST begin with three slashes
Return: CF set on error
AX = error code (see #01680 at AH=59h/BX=0000h)
CF clear if successful
SeeAlso: AX=5F08h"STARLITE"
--------D-215F08-----------------------------
INT 21 - DOS 5+ - DISABLE DRIVE
AX = 5F08h
DL = drive number (0=A:)
Return: CF clear if successful
CF set on error
AX = error code (0Fh) (see #01680 at AH=59h/BX=0000h)
Notes: simply clears the "valid" bit in the drive's CDS
this function is not supported by Novell DOS 7 through at least
Update 4, but support was added by Update 13
SeeAlso: AH=52h,AX=5F07h"DOS"
--------O-215F08-----------------------------
INT 21 - STARLITE architecture - REMOVE GLOBAL NETWORK NAME OF OBJECT
AX = 5F08h
DS:SI -> ASCIZ network name (not local name) of object to unshare
Return: CF set on error
AX = error code (see #01680 at AH=59h/BX=0000h)
CF clear if successful
SeeAlso: AX=5F07h"STARLITE"
--------O-215F09-----------------------------
INT 21 - STARLITE architecture - BIND TO NETWORK DEVICE
AX = 5F09h
DS:DX -> ASCIZ name of the device driver to attach to
Return: CF set on error
AX = error code (see #01680 at AH=59h/BX=0000h)
CF clear if successful
Note: the STARLITE distributed file system can attach to multiple networks
simultaneously
SeeAlso: AX=5F0Ah
--------O-215F0A-----------------------------
INT 21 - STARLITE architecture - DETACH FROM NETWORK DEVICE
AX = 5F0Ah
DS:DX -> ASCIZ name of device driver to detach from
Return: CF set on error
AX = error code (see #01680 at AH=59h/BX=0000h)
CF clear if successful
SeeAlso: AX=5F09h
--------N-215F30-----------------------------
INT 21 U - LAN Manager Enhanced DOS - GET REDIRECTOR VERSION
AX = 5F30h
Return: AX = version (AH=major,AL=minor)
--------N-215F32-----------------------------
INT 21 u - Named Pipes - LOCAL DosQNmPipeInfo
AX = 5F32h
BX = handle
CX = size of _PIPEINFO structure
DX = level (must be 0001h)
DS:SI -> _PIPEINFO structure (see #01701)
Return: CF clear if successful
_PIPEINFO structure filled in
CF set on error
AX = error code
Note: this function was introduced by LAN Manager but is also supported by
the Novell DOS Named Pipe Extender, Banyan VINES, OS/2 Virtual DOS
Machines, and others
SeeAlso: AX=5F33h,AX=5F34h
Format of Named Pipes _PIPEINFO structure:
Offset Size Description (Table 01701)
00h WORD size of outgoing buffer
02h WORD size of incoming buffer
04h BYTE maximum number of instances allowed
05h BYTE current number of instances
06h BYTE length of the name (including terminating NUL)
07h N BYTEs name
--------N-215F33-----------------------------
INT 21 u - Named Pipes - LOCAL DosQNmPHandState
AX = 5F33h
BX = handle
Return: CF clear if successful
AH = pipe mode bit mask (see #01702)
AL = maximum number of instances
CF set on error
AX = error code
Note: this function was introduced by LAN Manager but is also supported by
the Novell DOS Named Pipe Extender, Banyan VINES, OS/2 Virtual DOS
Machines, and others
SeeAlso: AX=5F32h,AX=5F34h
Bitfields for Named Pipes pipe mode:
Bit(s) Description (Table 01702)
7 set if nonblocking, clear if blocking
6 set if server end, clear if client end
2 set if write in message mode, clear if write in byte mode
0 set if read in message mode, clear if read in byte mode
--------N-215F34-----------------------------
INT 21 u - Named Pipes - LOCAL DosSetNmPHandState
AX = 5F34h
BX = handle
CX = pipe mode bit mask
bit 15: set if nonblocking, clear if blocking
bit 8: set if read in message mode, clear if read in byte mode
Return: CF clear if successful
CF set if error
AX = error code
Note: this function was introduced by LAN Manager but is also supported by
the Novell DOS Named Pipe Extender, Banyan VINES, OS/2 Virtual DOS
Machines, and others
SeeAlso: AX=5F32h,AX=5F33h,AX=5F36h
--------N-215F35-----------------------------
INT 21 u - Named Pipes - LOCAL DosPeekNmPipe
AX = 5F35h
BX = handle
CX = buffer length
DS:SI -> buffer
Return: CF set on error
AX = error code
CF clear if successful (LAN Manager v1-v2)
AX = 0000h if successful (LAN Manager 3.x)
---if successful---
CX = bytes read
SI = bytes left in the pipe
DX = bytes left in the current message
AX = pipe status (v1-v2) (see #01703)
DI = pipe status (v3.x)
Note: this function was introduced by LAN Manager but is also supported by
the Novell DOS Named Pipe Extender, Banyan VINES, OS/2 Virtual DOS
Machines, and others
SeeAlso: AX=5F38h,AX=5F39h,AX=5F51h
(Table 01703)
Values for pipe status:
0001h disconnected
0002h listening
0003h connected
0004h closing
--------N-215F36-----------------------------
INT 21 u - Named Pipes - LOCAL DosTransactNmPipe
AX = 5F36h
BX = handle
CX = in buffer length
DS:SI -> in buffer
DX = out buffer length
ES:DI -> out buffer
Return: CF clear if successful
CX = bytes read
CF set on error
AX = error code
Note: this function was introduced by LAN Manager but is also supported by
the Novell DOS Named Pipe Extender, Banyan VINES, OS/2 Virtual DOS
Machines, and others
SeeAlso: AX=5F34h,AX=5F37h
--------N-215F37-----------------------------
INT 21 u - Named Pipes - DosCallNmPipe
AX = 5F37h
DS:SI -> DosCallNmPipe stack frame (see #01704)
Return: CF clear if successful
CX = bytes read
CF set on error
AX = error code
Note: this function was introduced by LAN Manager but is also supported by
the Novell DOS Named Pipe Extender, Banyan VINES, OS/2 Virtual DOS
Machines, and others
SeeAlso: AX=5F36h,AX=5F38h
Format of Named Pipes DosCallNmPipe stack frame:
Offset Size Description (Table 01704)
00h DWORD timeout
04h DWORD -> bytes read WORD (not used!)
08h WORD out buffer length
0Ah DWORD address of out buffer
0Eh WORD in buffer length
10h DWORD address of in buffer
14h DWORD address of pipe name
--------N-215F38-----------------------------
INT 21 u - Named Pipes - LOCAL DosWaitNmPipe - AWAIT AVAIL. OF PIPE INSTANCE
AX = 5F38h
DS:DX -> pipe name
BX:CX = timeout value
Return: CF clear if successful
CF set if error
AX = error code
Notes: when a client gets a return code of ERROR_PIPE_BUSY on attempting to
open a pipe, it should issue this call to wait until the pipe
instance becomes available again; on return from this call, the
client must attempt to open the pipe once again
this function was introduced by LAN Manager but is also supported by
the Novell DOS Named Pipe Extender, Banyan VINES, OS/2 Virtual DOS
Machines, and others
SeeAlso: AX=5F37h,AX=5F39h
--------N-215F39-----------------------------
INT 21 U - Named Pipes - LOCAL DosRawReadNmPipe
AX = 5F39h
BX = handle
CX = buffer length
DS:DX -> buffer
Return: CF clear if successful
CX = bytes read
CF set if error
⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -