NWDestroyQueue(3nw)
NWDestroyQueue --
deletes the specified queue
Synopsis
#include <nwqms.h>
or
#include <nwcalls.h>
NWCCODE N_API NWDestroyQueue
(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 to be deleted.
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_QUEUE_FULL
- 0x89D5
-
ERR_NO_Q_JOB
- 0x89D6
-
ERR_NO_Q_JOB_RIGHTS
- 0x89D7
-
ERR_Q_IN_SERVICE
- 0x89D8
-
ERR_Q_NOT_ACTIVE
- 0x89D9
-
ERR_Q_STN_NOT_SERVER
- 0x89DA
-
ERR_Q_HALTED
- 0x89DB
-
ERR_Q_MAX_SERVERS
- 0x89FF
-
Failure
Notices
All active jobs are aborted, all servers are detached from the queue, and all jobs in the queue are deleted, along with their associated files. The queue object and its
associated properties are also removed from the Bindery and the queue's subdirectory is deleted.
Only SUPERVISOR or a Bindery object that is security equivalent to SUPERVISOR can destroy a queue.
Services
Queue Management
NCP calls
- 0x2222 23 101
-
Destroy Queue
30 January 1998
© 1998 The Santa Cruz Operation, Inc. All rights reserved.