NWPSCfgAddPrinterAttr(3nw)
NWPSCfgAddPrinterAttr --
adds attribute to existing printer
Synopsis
#include <nwps_cfg.h>
or
#include <nwpsrv.h>
NWCCODE NWAPI NWPSCfgAddPrinterAttr
(WORD connType,
DWORD connID,
char NWFAR
pServerName,
char NWFAR
printerName,
WORD attrID,
void NWFAR
attrValue);
Description
The parameters are as follows:
- connType
-
(IN) Specifies either NWPS_BINDERY_SERVICE_PRE_40,
NWPS_BINDERY_SERVICE, or NWPS_DIRECTORY_SERVICE.
- connID
-
(IN) Specifies the connection or context identifier.
- pServerName
-
(IN) Points to the name of the print server.
- printerName
-
(IN) Points to the name of the printer.
- attrID
-
(IN) Specifies the print services attribute identifier.
- attrValue
-
(IN) Points to the attribute buffer.
Return values
- 0x0000
-
Successful
- -1
-
General Error
- other
-
Bindery or Directory Services Errors
Notices
The type of the buffer pointed to by attrValue depends on the
value of attrID. If attrID is not recognized, an error
is returned.
If attrValue is single-valued, the new value overwrites the
old value. If attrValue is multi-valued, the new attribute value
is added to the list.
Legal attribute identifiers and values for the printer configuration follow:
Bindery Identifier
|
Directory Identifier
|
Type
|
Multi Valued
|
None
|
NWPS_ATTR_ACL
|
Object_ACL_T
|
Yes
|
None
|
NWPS_ATTR_CART
|
char[ ]
|
Yes
|
NWPS_ATTR_CN
|
NWPS_ATTR_CN
|
char[ ]
|
No
|
NWPS_ATTR_CONF
|
NWPS_ATTR_CONF
|
Octet_String_T
|
No
|
NWPS_ATTR_DESC
|
NWPS_ATTR_DESC
|
char[ ]
|
No
|
NWPS_ATTR_DQUEUE
|
NWPS_ATTR_DQUEUE
|
char[ ]
|
No
|
None
|
NWPS_ATTR_HOST_DEV
|
char[ ]
|
No
|
None
|
NWPS_ATTR_MEMORY
|
Integer_T
|
No
|
None
|
NWPS_ATTR_NADD
|
Net_Address_T
|
Yes
|
None
|
NWPS_ATTR_NADD_REST
|
Net_Address_T
|
Yes
|
NWPS_ATTR_NOTIFY
|
NWPS_ATTR_NOTIFY
|
NWPS_Typed_Name
|
Yes
|
NWPS_ATTR_OPER
|
NWPS_ATTR_OPER
|
char[ ]
|
Yes
|
NWPS_ATTR_OWNER
|
NWPS_ATTR_OWNER
|
char[ ]
|
Yes
|
None
|
NWPS_ATTR_PAGE
|
char[ ]
|
Yes
|
NWPS_ATTR_PRINT_SER
|
NWPS_ATTR_PRINT_SER
|
Typed_Name_T
|
No
|
NWPS_ATTR_QUEUE
|
NWPS_ATTR_QUEUE
|
Typed_Name_T
|
Yes
|
None
|
NWPS_ATTR_SEE_ALSO
|
char[ ]
|
Yes
|
None
|
NWPS_ATTR_SERIAL
|
char[ ]
|
Yes
|
NWPS_ATTR_STAT
|
NWPS_ATTR_STAT
|
Integer_T
|
No
|
None
|
NWPS_ATTR_TYPE (faces)
|
char[ ]
|
Yes
|
char[ ] is a NULL-terminated character string.
NWPS_ATTR_STAT values follow:
0 = NWPS_PSTAT_JOB_WAIT
1 = NWPS_PSTAT_FORM_WAIT
2 = NWPS_PSTAT_PRINTING
3 = NWPS_PSTAT_PAUSED
4 = NWPS_PSTAT_STOPPED
5 = NWPS_PSTAT_MARK_EJECT
6 = NWPS_PSTAT_READY_TO_DOWN
7 = NWPS_PSTAT_NOT_CONNECTED
8 = NWPS_PSTAT_PRIVATE
Services
Print Server
References
NWPSCfgAddPrinter(3nw),
NWPSCfgDeletePrinterAttr(3nw),
NWPSCfgGetFirstPrinterAttr(3nw),
NWPSCfgGetNextPrinterAttr(3nw),
NWPSCfgEndNextPrinterAttr(3nw),
NWPSCfgModifyPrinterAttr(3nw),
NWPSCfgGetFirstPrintServer(3nw),
NWPSCfgGetNextPrintServer(3nw),
NWPSCfgEndNextPrintServer(3nw),
NWPSCfgVerifyPrintServer(3nw),
NWCCOpenConnByName(3nw),
NWDSCreateContext(3nw)
30 January 1998
© 1998 The Santa Cruz Operation, Inc. All rights reserved.