NWPSCfgModifyPrintQueueAttr(3nw)
NWPSCfgModifyPrintQueueAttr --
changes old print queue attribute value to new value
Synopsis
#include <nwps_cfg.h>
or
#include <nwpsrv.h>
NWCCODE NWAPI NWPSCfgModifyPrintQueueAttr
(WORD connType,
DWORD connID,
char NWFAR
queueName,
WORD attrID,
void NWFAR
oldValue,
void NWFAR
newValue);
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 queue name to modify.
- attrID
-
(IN) Specifies the print services attribute identifier.
- oldValue
-
(IN) Points to the old attribute value.
- newValue
-
(IN) Points to the new attribute value.
Return values
- 0x0000
-
Successful
- -1
-
General Error
- other
-
Bindery or Directory Services Errors
Notices
NWPSCfgModifyPrintQueueAttr fails if the old value cannot be
matched exactly or if the new value is invalid.
The only way to change single-valued, required attributes is by calling
NWPSCfgModifyPrintQueueAttr.
The type of the buffer pointed to by oldValue and
newValue depends on the value of attrID. If
attrID is not recognized, an error is returned.
Legal attribute identifiers for the printer's queue follow:
Bindery Identifier
|
Directory Identifier
|
Type
|
Multi Valued
|
None
|
NWPS_ATTR_ACL
|
Object_ACL_T
|
Yes
|
NWPS_ATTR_CN
|
NWPS_ATTR_CN
|
char[ ]
|
No
|
NWPS_ATTR_DESC
|
NWPS_ATTR_DESC
|
char[ ]
|
No
|
NWPS_ATTR_DEVICE
|
NWPS_ATTR_DEVICE
|
char[ ]
|
Yes
|
NWPS_ATTR_HOST_RES
|
NWPS_ATTR_HOST_RES
|
char[ ]
|
No
|
NWPS_ATTR_HOST_SER
|
NWPS_ATTR_HOST_SER
|
char[ ]
|
No
|
None
|
NWPS_ATTR_NADD
|
Net_Address_T
|
Yes
|
NWPS_ATTR_OPER
|
NWPS_ATTR_OPER
|
char[ ]
|
Yes
|
NWPS_ATTR_QUE_DIR
|
NWPS_ATTR_QUE_DIR
|
NWPS_Typed_Name
|
Yes
|
None
|
NWPS_ATTR_SEE_ALSO
|
char[ ]
|
Yes
|
NWPS_ATTR_SERVER
|
NWPS_ATTR_SERVER
|
char[ ]
|
Yes
|
NWPS_ATTR_USER
|
NWPS_ATTR_USER
|
NWPS_Typed_Name
|
Yes
|
NWPS_ATTR_VOLUME
|
NWPS_ATTR_VOLUME
|
char[ ]
|
No
|
char[ ] is a NULL-terminated ASCII string.
Services
Print Server
References
NWPSCfgAddPrintQueueAttr(3nw),
NWPSCfgDeletePrintQueueAttr(3nw),
NWPSCfgGetFirstPrintQueueAttr(3nw),
NWPSCfgGetNextPrintQueueAttr(3nw),
NWPSCfgEndNextPrintQueueAttr(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.