NWPSCfgModifyPrintServerAttr(3nw)
NWPSCfgModifyPrintServerAttr --
changes print server attribute from one value to another
Synopsis
#include <nwps_cfg.h>
or
#include <nwpsrv.h>
NWCCODE NWAPI NWPSCfgModifyPrintServerAttr
(WORD connType,
DWORD connID,
char NWFAR
pServerName,
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.
- pServerName
-
(IN) Points to the name of the print server.
- attrID
-
(IN) Specifies the print server 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
NWPSCfgModifyPrintServerAttr 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
NWPSCfgModifyPrintServerAttr.
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 identifier and values for the print server are as follows:
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
|
None
|
NWPS_ATTR_HOST_DEV
|
char[ ]
|
No
|
None
|
NWPS_ATTR_NADD
|
Net_Address_T
|
Yes
|
NWPS_ATTR_OPER
|
NWPS_ATTR_OPER
|
char[ ]
|
Yes
|
NWPS_ATTR_PRINTER
|
NWPS_ATTR_PRINTER
|
Typed_Name_T
|
Yes
|
None
|
NWPS_ATTR_PRIV_KEY
|
Octet_String_T
|
No
|
None
|
NWPS_ATTR_PUBL_KEY
|
Octet_String_T
|
No
|
NWPS_ATTR_DEVICE
|
NWPS_ATTR_SAP
|
char[ ]
|
No
|
None
|
NWPS_ATTR_SEE_ALSO
|
char[ ]
|
Yes
|
None
|
NWPS_ATTR_STAT
|
Integer_T
|
No
|
NWPS_ATTR_USER
|
NWPS_ATTR_USER
|
char[ ]
|
Yes
|
None
|
NWPS_ATTR_VERS
|
char[ ]
|
No
|
char[ ] is a NULL-terminated ASCII string.
NWPS_ATTR_STAT values follow:
0 = NWPS_RUNNING
1 = NWPS_GOING_DOWN
2 = NWPS_DOWN
3 = NWPS_INITIALIZING
Services
Print Server
References
NWPSCfgAddPrintServerAttr(3nw),
NWPSCfgDeletePrintServerAttr(3nw),
NWPSCfgGetFirstPrintServerAttr(3nw),
NWPSCfgGetNextPrintServerAttr(3nw),
NWPSCfgEndNextPrintServerAttr(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.