NWPSCfgGetFirstPrintServerAttr(3nw)

NWPSCfgGetFirstPrintServerAttr -- retrieves first print server attribute value

Synopsis

   #include <nwps_cfg.h> 
   or 
   #include <nwpsrv.h> 
    
   NWCCODE NWAPI NWPSCfgGetFirstPrintServerAttr 
     (WORD                    connType, 
      DWORD                   connID, 
      char NWFAR             pServerName, 
      WORD                    attrID, 
      NWPSListHandle NWFAR   handle, 
      void NWFAR             attrValue);

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 services attribute identifier.
handle: (OUT) Points to the value to be passed to NWPSCfgGetNextPrintServerAttr and NWPSCfgEndNextPrintServerAttr (optional).
attrValue: (OUT) Points to the buffer in which to place the first attribute found. Its maximum length is MAX_DN_BYTES + sizeof(NWPSTypedName).

Return values

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

Notices

Memory allocated and files opened by NWPSCfgGetFirstPrintServerAttr must be respectively deallocated and closed by calling NWPSCfgEndNextPrintServerAttr. If the completion code is non-zero or if the attribute requested is single-valued, the value returned for the handle is zero. In this case, calling NWPSCfgEndNextPrintServerAttr is not required.

The type of the buffer pointed to by attrValue depends on the value of attrID. If attrIDs 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 are as follows:

0: NWPS_RUNNING
1: NWPS_GOING_DOWN
2: NWPS_DOWN
3: NWPS_INITIALIZING

Services

Print Server

References

NWPSCfgEndNextPrintServerAttr(3nw), NWPSCfgGetNextPrintServerAttr(3nw)