NWPSCfgGetNextPrinter(3nw)


NWPSCfgGetNextPrinter -- retrieves next printer name from list

Synopsis

   #include <nwpsrv.h> 
   

NWCCODE NWAPI NWPSCfgGetNextPrinter (NWPSListHandle handle, char NWFAR *pServerName, char NWFAR *printerName);

Description

The parameters are as follows:

handle
(IN) Specifies the value returned from NWPSCfgGetFirstPrinter.

pServerName
(OUT) Points to the name of the print server (optional).

printerName
(OUT) Points to the name of the next printer found. Its maximum length is MAX_DN_BYTES for Directory Services; 48 characters for other services.

Return values

0x0000
Successful

0x7760
NWPSE_END_OF_LIST

-1
General Error

other
Bindery or Directory Services Errors

Notices

If the handle is zero, NWPSE_END_OF_LIST is returned, indicating the end of the list of printers.

pServerName must match the parameter passed in NWPSCfgGetFirstPrinter. If a print server name or a NULL was passed in NWPSCfgGetFirstPrinter, pServerName is ignored. However, if the address of an empty string was passed to NWPSCfgGetFirstPrinter, data for all printers includes print servers; and the address of a destination buffer for the print server should be passed to NWPSCfgGetFirstPrinter.

A NULL pointer is allowed for pServerName in this case, but it is highly inefficient because the data is retrieved from the NetWare server only to be discarded by NWPSCfgGetFirstPrinter.

Services

Print Server

References

NWPSCfgGetFirstPrinter(3nw), NWPSCfgEndNextPrinter(3nw), NWPSCfgVerifyPrinter(3nw)
30 January 1998
© 1998 The Santa Cruz Operation, Inc. All rights reserved.