NWPSCfgAddPrintQueue(3nw)


NWPSCfgAddPrintQueue -- creates print queue using default operator and user attributes

Synopsis

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

NWCCODE NWAPI NWPSCfgAddPrintQueue (WORD connType, DWORD connID, char NWFAR *queueName, char NWFAR *volumeName);

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.

queueName
(IN) Points to the name of the print queue.

volumeName
(IN) Points to the volume name where the queue directory is to be created.

Return values

0x0000
Successful

-1
General Error

other
Bindery or Directory Services Errors

Notices

In NWPS_BINDERY_SERVICE mode, the volume name is automatically assigned; therefore, volumeName is ignored. In NWPS_DIRECTORY_SERVICE mode, volumeName must be a valid directory volume object.

After the queue is created, it can be added to a printer with NWPSCfgAddPrinterAttr, using either NWPS_ATTR_DQUEUE or NWPS_ATTR_QUEUE. When a queue is created, it is assigned a default NWPS_ATTR_QUE_DIR. This applies to both NWPS_DIRECTORY_SERVICE and NWPS_BINDERY_SERVICE.

In NWPS_BINDERY_SERVICE, the operator is set to the currently logged-in user and the user is set to EVERYONE. If the user group EVERYONE does not exist, the currently logged-in user is added to the list of users explicitly. A local server is assumed.

In NWPS_DIRECTORY_SERVICE, the list of operators is set to the current user and the list of users is set to the organizational unit. If there is a group EVERYONE under the organizational unit, it is also added to the list of users for compatibility with Bindery emulation.

The default value for NWPS_ATTR_VOLUME is the volume name. The default value for NWPS_ATTR_HOST_SER is the name of the NetWare server where the volume is found.

Services

Print Server

References

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