9.127 LIST_PRINTERS
注意: 9.1 組み込み関数の規則 利用オプション
このBIFは、マシンに現在構成されているプリンターのリストを返します。
Windows Vistaで実行する場合は、「技術上の注記」を参照してください。
引数
番号 | タイプ | 必須/任意 | 記述 | 最小長 | 最大長 | 最小小数桁数 | 最大小数桁数 |
|---|---|---|---|---|---|---|---|
1 | A | 任意 | プリンターの場所 A:すべてのプリンター L:ローカルのみ - IBM iの場合は常に使用 デフォルトはAです。 | 1 | 1 |
戻り値
番号 | タイプ | 必須/任意 | 記述 | 最小長 | 最大長 | 最小小数桁数 | 最大小数桁数 |
|---|---|---|---|---|---|---|---|
1 | L | 必須 | プリンターの名前全体が保持された作業リスト(「技術上の注記」を参照) このリストの形式は以下のとおりです。 開始 - 終了 説明 | 255 | 255 | ||
2 | A | 必須 | 戻りコード OK:リストが正常に戻された OV:リストがいっぱいの状態で戻され、リストに収まらないプリンターがさらに存在する NR:空のリストが戻された ER:エラーが発生した | 2 | 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)