NWPSComChangeQueuePriority(3nw)


NWPSComChangeQueuePriority -- changes service priority assigned to queue

Synopsis

   #include <nwpsrv.h> 
   

NWCCODE NWAPI NWPSComChangeQueuePriority (WORD spxID, WORD printerID, char NWFAR *nServerName, char NWFAR *queueName, WORD priority);

Description

The parameters are as follows:

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

printerID
(IN) Specifies the printer (0 to maximum number of printers).

nServerName
(IN) Points to the name of the object's NetWare server.

queueName
(IN) Points to the name of the queue to be changed.

priority
(IN) Specifies the new priority to give to the queue.

Return values

0x0000
NWPSE_SUCCESSFUL

0x00ED
NWPSE_CONNECTION_TERMINATED

0x0103
NWPSE_BINDERY_LOCKED

0x0301
NWPSE_NOT_ENOUGH_MEMORY

0x0302
NWPSE_NO_SUCH_PRINTER

0x030A
NWPSE_NOT_ATTACHED_TO_SERVER

0x030C
NWPSE_DOWN

0x030D
NWPSE_NOT_IN_LIST

0x030E
NWPSE_NO_RIGHTS

Notices

Before calling NWPSComChangeQueuePriority, the operator must be attached to the NetWare server where the queue exists. Attempts to get information about a queue will fail if the queue is not on the specified NetWare server or if the queue is not in the print server list.

NWPSComChangeQueuePriority is for operators only.

Services

Print Server

NCP calls

None

References

NWPSComAddQueueToPrinter(3nw), NWPSComAttachToPrintServer(3nw), NWPSComDeleteQueueFromPrinter(3nw), NWPSComGetPrintersServicingQ(3nw), NWPSComGetQueuesServiced(3nw), NWPSComLoginToPrintServer(3nw), NWScanObject(3nw)
30 January 1998
© 1998 The Santa Cruz Operation, Inc. All rights reserved.