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

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

 
 --------------------------------------------------------------------------- 
| 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)