NWAttachQueueServerToQueue(3nw)


NWAttachQueueServerToQueue -- attaches the calling station to the specified queue as a queue server

Synopsis

   #include <nwqms.h> 
   or 
   #include <nwcalls.h> 
   

NWCCODE N_API NWAttachQueueServerToQueue (NWCONN_HANDLE conn, nuint32 queueID);

Description

The parameters are as follows:

conn
(IN) Specifies the NetWare server connection handle.

queueID
(IN) Specifies the bindery object ID of the queue being attached.

Return values

0x0000
SUCCESSFUL

0x8999
DIRECTORY_FULL

0x89D0
ERR_Q_IO_FAILURE

0x89D1
ERR_NO_QUEUE

0x89D2
ERR_NO_Q_SERVER

0x89D3
ERR_NO_Q_RIGHTS

0x89D4
ERR_Q_FULL

0x89D3
ERR_NO_Q_RIGHTS

0x89D5
ERR_NO_Q_JOB

0x89D6
ERR_NO_Q_JOB_RIGHTS

0x89D7
ERR_NO_Q_IN_SERVICE

0x89D8
ERR_Q_NOT_ACTIVE

0x89D9
ERR_Q_STN_NOT_SERVER

0x89DA
ERR_Q_HALTED

0x89DB
ERR_Q_MAX_SERVERS

0x89EA
NO_SUCH_MEMBER

0x89FC
NO_SUCH_OBJECT

0x89FF
Failure, HARDWARE_FAILURE

Notices

A station must attach itself to a queue as a job server before it can service jobs from that queue. A queue can have as many as 25 job servers attached.

The workstation calling NWAttachQueueServerToQueue must be security equivalent to one of the objects listed in the queue's Q_SERVERS property.

Services

Queue Management

NCP calls

0x2222 23 111 Attach Queue Server To Queue

References

NWCreateQueue(3nw), NWDetachQueueServerFromQueue(3nw),


30 January 1998
© 1998 The Santa Cruz Operation, Inc. All rights reserved.