Gets the name of the next enumerated printer.
Note: This routine is supported for native COBOL only.
Syntax:
call "PC_PRINTER_ENUM_START" using by value enum-handle
by reference printer-name
Parameters
-
enum-handle
- Call prototype (see Key): cblt-pointer
- Picture: pointer.
-
printer-name
- A group predefined as
01 printer-name typedef.
03 cblte-pn-name-len pic x(2) comp-5.
03 cblte-pn-name pic x(n).
On Entry:
-
enum-handle
- Valid enum-handle returned from PC_PRINTER_ENUM_START.
-
cblte-pn-name-len
- The length of cblte-pn-name.
-
cblte-pn-name
- Not set.
On Exit:
-
cblte-pn-name-len
- The length of cblte-pn-name returned.
-
cblte-pn-name
- The printer name.
- return-value
- One of:
- 0
- Enumeration started
- 29
- End of enumeration
- 30
- cblte-pn-name is too small
- or another PC_PRINTER error code
Comments
If cblte-pn-name-len is zero on entry, then cblte-pn-name-len is updated with the size required for cblte-pn-name (not the size of the group) and the enumeration remains on the current entry.