NWPSCfgModifyPrinterAttr(3nw)

NWPSCfgModifyPrinterAttr -- changes printer attribute value in bindery or directory

Synopsis

   #include <nwps_cfg.h> 
   or 
   #include <nwpsrv.h> 
    
   NWCCODE NWAPI NWPSCfgModifyPrinterAttr 
     (WORD          connType, 
      DWORD         connID, 
      char NWFAR   pServerName, 
      char NWFAR   printerName, 
      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.
printerName: (IN) Points to the name of the printer.
attrID: (IN) Specifies the print services attribute identifier.
oldValue: (IN) Points to the attribute value to remove.
newValue: (IN) Points to the attribute value to add.

Return values

0x0000: Successful
-1: General Error
other: Bindery or Directory Services Errors

Notices

NWPSCfgModifyPrinterAttr 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 NWPSCfgModifyPrinterAttr.

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

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

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

NWPSCfgAddPrinterAttr(3nw), NWPSCfgDeletePrinterAttr(3nw), NWPSCfgGetFirstPrintServer(3nw), NWPSCfgGetNextPrintServer(3nw), NWPSCfgEndNextPrintServer(3nw), NWPSCfgVerifyPrintServer(3nw), NWCCOpenConnByName(3nw), NWDSCreateContext(3nw)