Int 21H [3.1] Function 5EH (94) Subfunction 03H Get printer setup string

Obtains the printer setup string for a particular network printer. This function call is only available when Microsoft Networks is running.

Call with:

AH = 5EH

AL = 03H

BX = redirection list index

ES:DI = segment:offset of buffer to receive setup string

Returns:

If function successful

Carry flag = clear

CX = length of printer setup string

ES:DI = address of buffer holding setup string

If function unsuccessful

Carry flag = set

AX = error code

Notes:

The redirection list index passed in register BX is obtained with Function 5FH Subfunction 02H (Get Redirection List Entry).

See also Int 21H Function 5EH Subfunction 02H, which is used to specify a setup string for a network printer.

Example:

Get the setup string for this network node associated with the printer designated by redirection list index 2.

setup db 64 dup (?) ; receives setup string

.

.

.

mov ax,5e03h ; function & subfunction

mov bx,2 ; redirection list index 2

mov di,seg setup ; address of buffer

mov es,di

mov di,offset setup

int 21h ; transfer to MS-DOS

jc error ; jump if function failed

.

.

.