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.