PRINTER_INFO_2構造体

[アーティクル]
06/12/2023

PRINTER_INFO_2構造体は、プリンターの詳細な情報を指定します。

構文

typedef struct _PRINTER_INFO_2 {
  LPTSTR               pServerName;
  LPTSTR               pPrinterName;
  LPTSTR               pShareName;
  LPTSTR               pPortName;
  LPTSTR               pDriverName;
  LPTSTR               pComment;
  LPTSTR               pLocation;
  LPDEVMODE            pDevMode;
  LPTSTR               pSepFile;
  LPTSTR               pPrintProcessor;
  LPTSTR               pDatatype;
  LPTSTR               pParameters;
  PSECURITY_DESCRIPTOR pSecurityDescriptor;
  DWORD                Attributes;
  DWORD                Priority;
  DWORD                DefaultPriority;
  DWORD                StartTime;
  DWORD                UntilTime;
  DWORD                Status;
  DWORD                cJobs;
  DWORD                AveragePPM;
} PRINTER_INFO_2, *PPRINTER_INFO_2;

メンバー

pServerName

プリンターを制御するサーバーを識別する null で終わる文字列へのポインター。この文字列が NULL の場合、プリンターはローカルで制御されます。

pPrinterName

プリンターの名前を指定する null で終わる文字列へのポインター。

pShareName

プリンターの共有ポイントを識別する null で終わる文字列へのポインター。 (この文字列は、PRINTER_ATTRIBUTE_SHARED定数が Attributes メンバーに設定されている場合にのみ使用されます)。

pPortName

プリンターにデータを送信するために使用されるポートを識別する null で終わる文字列へのポインター。プリンターが複数のポートに接続されている場合、各ポートの名前はコンマで区切る必要があります (例: "LPT1:,LPT2:,LPT3:")。

pDriverName

プリンタードライバーの名前を指定する null で終わる文字列へのポインター。

pComment

プリンターの簡単な説明を提供する null で終わる文字列へのポインター。

pLocation

プリンターの物理的な場所を指定する null で終わる文字列へのポインター (例: "ビル 38,Room 1164")。

pDevMode

用紙の向きや解像度などの既定のプリンターデータを定義する DEVMODE 構造体へのポインター。

pSepFile

区切り記号ページの作成に使用するファイルの名前を指定する null で終わる文字列へのポインター。このページは、プリンターに送信される印刷ジョブを分離するために使用されます。

pPrintProcessor

プリンターで使用される印刷プロセッサの名前を指定する null で終わる文字列へのポインター。 EnumPrintProcessors 関数を使用すると、サーバーにインストールされている印刷プロセッサの一覧を取得できます。

pDatatype

印刷ジョブの記録に使用されるデータ型を指定する null で終わる文字列へのポインター。 EnumPrintProcessorDatatypes 関数を使用すると、特定の印刷プロセッサでサポートされているデータ型の一覧を取得できます。

pParameters

既定の印刷プロセッサパラメーターを指定する null で終わる文字列へのポインター。

pSecurityDescriptor

プリンターの SECURITY_DESCRIPTOR 構造体へのポインター。このメンバーは NULL である可能性があります。

属性

プリンター属性。このメンバーには、次の値の任意の適切な組み合わせを指定できます。

値	説明
PRINTER_ATTRIBUTE_DIRECT	ジョブはプリンターに直接送信されます (スプールされません)。
PRINTER_ATTRIBUTE_DO_COMPLETE_FIRST	印刷時スプーリング用に set と printer が設定されている場合、スプールが完了したジョブは、スプールを完了していないジョブの前に印刷するようにスケジュールされます。
PRINTER_ATTRIBUTE_ENABLE_DEVQ	set の場合、 DevQueryPrint が呼び出されます。ドキュメントとプリンターのセットアップが一致しない場合、DevQueryPrint が失敗する可能性があります。このフラグを設定すると、不一致のドキュメントがキューに保持されます。
PRINTER_ATTRIBUTE_HIDDEN	予約済み。
PRINTER_ATTRIBUTE_KEEPPRINTEDJOBS	設定した場合、ジョブは印刷後も保持されます。未設定の場合、ジョブは削除されます。
PRINTER_ATTRIBUTE_LOCAL	プリンターはローカルプリンターです。
PRINTER_ATTRIBUTE_NETWORK	プリンターはネットワークプリンター接続です。
PRINTER_ATTRIBUTE_PUBLISHED	プリンターがディレクトリサービスで発行されているかどうかを示します。
PRINTER_ATTRIBUTE_QUEUED	設定した場合、プリンターはスプールし、最後のページがスプールされた後に印刷を開始します。が設定されておらず、PRINTER_ATTRIBUTE_DIRECTが設定されていない場合、プリンターはスプール中にスプールおよび印刷されます。
PRINTER_ATTRIBUTE_RAW_ONLY	生データ型の印刷ジョブのみをスプールできることを示します。
PRINTER_ATTRIBUTE_SHARED	プリンターは共有されます。

Windows XP 以降のバージョンの Windows では、次の値を使用することもできます。

値	説明
PRINTER_ATTRIBUTE_FAX	設定されている場合、プリンターは FAX プリンターです。これは AddPrinter でのみ設定できますが、 EnumPrinters と GetPrinter によって取得できます。

Windows Vista 以降のバージョンの Windows では、次の値を使用することもできます。

値	説明
PRINTER_ATTRIBUTE_FRIENDLY_NAME	コンピューターがこのプリンターに接続され、わかりやすい名前が付けられます。
PRINTER_ATTRIBUTE_MACHINE	プリンターはマシンごとの接続です。
PRINTER_ATTRIBUTE_PUSHED_USER	プリンターは、プッシュプリンター接続ユーザーポリシーを使用してインストールされました。
PRINTER_ATTRIBUTE_PUSHED_MACHINE	プリンターは、プッシュプリンター接続コンピューターポリシーを使用してインストールされました。

Windows Server 2003 では、次の値を使用することもできます。

値	説明
PRINTER_ATTRIBUTE_TS	プリンターが現在ターミナルサーバー経由で接続されていることを示します。

優先順位

スプーラーが印刷ジョブのルーティングに使用する優先順位の値。

DefaultPriority

各印刷ジョブに割り当てられる既定の優先度の値。

StartTime

プリンターがジョブを印刷する最も早い時刻。この値は、GMT (グリニッジ標準時) の午前 12 時から経過した分として表されます。

UntilTime

プリンターがジョブを印刷する最新時刻。この値は、GMT (グリニッジ標準時) の午前 12 時から経過した分として表されます。

状態

プリンターの状態。このメンバーは、次の値の任意の適切な組み合わせにすることができます。

値	説明
PRINTER_STATUS_BUSY	プリンターがビジーです。
PRINTER_STATUS_DOOR_OPEN	プリンターのドアが開いています。
PRINTER_STATUS_ERROR	プリンターはエラー状態にあります。
PRINTER_STATUS_INITIALIZING	プリンターは初期化中です。
PRINTER_STATUS_IO_ACTIVE	プリンターがアクティブな入出力状態である
PRINTER_STATUS_MANUAL_FEED	プリンターが手動フィード状態です。
PRINTER_STATUS_NO_TONER	プリンターのトナーがありません。
PRINTER_STATUS_NOT_AVAILABLE	プリンターは印刷できません。
PRINTER_STATUS_OFFLINE	プリンターはオフラインです。
PRINTER_STATUS_OUT_OF_MEMORY	プリンターのメモリが不足しています。
PRINTER_STATUS_OUTPUT_BIN_FULL	プリンターの出力ビンがいっぱいです。
PRINTER_STATUS_PAGE_PUNT	プリンターは現在のページを印刷できません。
PRINTER_STATUS_PAPER_JAM	用紙がプリンターに詰まっている
PRINTER_STATUS_PAPER_OUT	プリンターが用紙切れです。
PRINTER_STATUS_PAPER_PROBLEM	プリンターに用紙の問題があります。
PRINTER_STATUS_PAUSED	プリンターが一時停止しています。
PRINTER_STATUS_PENDING_DELETION	プリンターが削除されています。
PRINTER_STATUS_POWER_SAVE	プリンターは省電力モードです。
PRINTER_STATUS_PRINTING	プリンターが印刷中です。
PRINTER_STATUS_PROCESSING	プリンターが印刷ジョブを処理しています。
PRINTER_STATUS_SERVER_UNKNOWN	プリンターの状態が不明です。
PRINTER_STATUS_TONER_LOW	トナーが少ない。
PRINTER_STATUS_USER_INTERVENTION	プリンターにエラーがあり、ユーザーは何かを行う必要があります。
PRINTER_STATUS_WAITING	プリンターが待機しています。
PRINTER_STATUS_WARMING_UP	プリンターはウォームアップ中です。

cJobs

プリンターのキューに入っている印刷ジョブの数。

AveragePPM

プリンターに印刷された 1 分あたりの平均ページ数。

要件

要件	値
サポートされている最小のクライアント	Windows 2000 Professional [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップアプリのみ]
ヘッダー	Winspool.h (Windows.h を含む)
Unicode 名と ANSI 名	_PRINTER_INFO_2W (Unicode) と _PRINTER_INFO_2A (ANSI)

PRINTER_INFO_2構造体

構文

メンバー

要件

関連項目

フィードバック

フィードバック

その他のリソース