NWPSCfgGetFirstPrintQueue(3nw)


NWPSCfgGetFirstPrintQueue -- finds first print queue on NetWare server or in directory context

Synopsis

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

NWCCODE NWAPI NWPSCfgGetFirstPrintQueue (WORD connType, DWORD connID, NWPSListHandle NWFAR *handle, char NWFAR *queueName);

Description

The parameters are as follows:

connType
(IN) Specifies either NWPS_BINDERY_SERVICE, NWPS_BINDERY_SERVICE_PRE_40, or NWPS_DIRECTORY_SERVICE.

connID
(IN) Specifies the connection or context identifier.

handle
(OUT) Points to the value passed by NWPSCfgGetNextPrintQueue and NWPSCfgEndNextPrintQueue.

queueName
(OUT) Points to the name of the first print queue 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

Files opened and memory allocated by NWPSCfgGetFirstPrintQueue must be respectively closed and deallocated by calling NWPSCfgEndNextPrintQueue. If the completion code is non-zero, the value returned for the handle is zero, and calling NWPSCfgEndNextPrintQueue is not required.

Services

Print Server

References

NWPSCfgEndNextPrintQueue(3nw), NWPSCfgGetNextPrintQueue(3nw), NWPSCfgVerifyPrintQueue(3nw)
30 January 1998
© 1998 The Santa Cruz Operation, Inc. All rights reserved.