NWPSComGetNextRemotePrinter(3nw)


NWPSComGetNextRemotePrinter -- returns number of next available printer

Synopsis

   #include <nwps_com.h> 
   or 
   #include <nwpsrv.h> 
   

NWCCODE NWAPI NWPSComGetNextRemotePrinter (WORD spxID, WORD NWFAR *printerID, WORD NWFAR *printerType, char NWFAR *printerName);

Description

The parameters are as follows:

spxID
(IN) Specifies the SPX connection to the print server.

printerID
(IN/OUT) Points to the printer number. Set printerID to -1 on the first call; thereafter it increments automatically. Printer numbers configured to active printers are skipped.

printerType
(OUT) Points to the type of printer.

printerName
(OUT) Points to the name of the printer.

Return values

0x0000
NWPSE_SUCCESSFUL

0x00ED
NWPSE_CONNECTION_TERMINATED

0x0301
NWPSE_NOT_ENOUGH_MEMORY

0x0302
NWPSE_NO_SUCH_PRINTER

0x030C
NWPSE_DOWN

Notices

NWPSComGetNextRemotePrinter applies only to printers remote in relation to the print server (user-loadable).

The printer number that is returned should be passed back on each subsequent call to get the next number for printerID.

Services

Print Server

NCP calls

None

References

NWPSComAttachToPrintServer(3nw), NWPSComGetPrinterStatus(3nw), NWPSComLoginToPrintServer(3nw), NWPSComRequestRemotePrinter(3nw)
30 January 1998
© 1998 The Santa Cruz Operation, Inc. All rights reserved.