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

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

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