9.127 LIST_PRINTERS

注意： 9.1 組み込み関数の規則利用オプション

このBIFは、マシンに現在構成されているプリンターのリストを返します。

Windows Vistaで実行する場合は、「技術上の注記」を参照してください。

引数

番号

タイプ

必須/任意

記述

最小長

最大長

最小小数桁数

最大小数桁数

1

A

任意

プリンターの場所

A：すべてのプリンター

L：ローカルのみ - IBM iの場合は常に使用

デフォルトはAです。

1

戻り値

番号

タイプ

必須/任意

記述

最小長

最大長

最小小数桁数

最大小数桁数

1

L

必須

プリンターの名前全体が保持された作業リスト（「技術上の注記」を参照）

このリストの形式は以下のとおりです。

開始 - 終了説明
1 - 255 プリンター名
256 - 256 プリンターの場所（L：ローカル、N：ネットワーク）

255

2

A

必須

戻りコード

OK：リストが正常に戻された

OV：リストがいっぱいの状態で戻され、リストに収まらないプリンターがさらに存在する

NR：空のリストが戻された

ER：エラーが発生した

2

技術上の注記

作業リストでは、プリンター名全体が返されます。リモート・プリンターの場合は、プリンター名にドメイン名が含まれ、//domain/PrinterName の形式になります。
（例：\\ourdomain\Epson Stylus COLOR 900）
サーバー・ファンクションによって印刷を行う場合、サーバーで利用可能なプリンターのリストを取得し、そのリストをクライアントに戻すには、このBIFをサーバーで実行する必要があります。その後、選択されたプリンター名がサーバー・ファンクションに送信され、印刷が実行されます。
Windows Vistaで実行する場合、この組み込み関数で定義できるプリンターの数に制限があります。この数には、ローカル・プリンターとリモート・プリンターの両方が含まれます。制限は、定義されるプリンターによって異なりますが、目安として、プリンター数を12に制限してください。

例

     FUNCTION OPTIONS(*DIRECT)
     DEF_LIST NAME(#PRNLIST) FIELDS(#PRN_NAME #PRN_LOC) TYPE(*WORKING)
     USE BUILTIN(LIST_PRINTERS) WITH_ARGS(A) TO_GET(#PRNLIST #STD_CMPAR)