PRINTER_NOTIFY_INFO_DATA構造体

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

PRINTER_NOTIFY_INFO_DATA構造体は、ジョブまたはプリンター情報フィールドを識別し、そのフィールドの現在のデータを提供します。

FindNextPrinterChangeNotification 関数は、PRINTER_NOTIFY_INFO_DATA構造体の配列を含むPRINTER_NOTIFY_INFO構造体を返します。

構文

typedef struct _PRINTER_NOTIFY_INFO_DATA {
  WORD  Type;
  WORD  Field;
  DWORD Reserved;
  DWORD Id;
  union {
    DWORD  adwData[2];
    struct {
      DWORD  cbBuf;
      LPVOID pBuf;
    } Data;
  } NotifyData;
} PRINTER_NOTIFY_INFO_DATA, *PPRINTER_NOTIFY_INFO_DATA; ;

メンバー

Type

提供される情報の種類を示します。このメンバーには、次のいずれかの値を指定できます。

値	説明
JOB_NOTIFY_TYPE 0x01	Field メンバーがJOB_NOTIFY_FIELD_* 定数を指定することを示します。
PRINTER_NOTIFY_TYPE 0x00	Field メンバーがPRINTER_NOTIFY_FIELD_* 定数を指定することを示します。

フィールド

変更されたフィールドを示します。使用可能な値の一覧については、「解説」セクションを参照してください。

Reserved

予約済み。

Id

Type メンバーがJOB_NOTIFY_TYPEを指定する場合は、ジョブ識別子を示します。 Type メンバーがPRINTER_NOTIFY_TYPEを指定した場合、このメンバーは未定義です。

NotifyData

Type メンバーと Field メンバーに基づくデータ情報の和集合。各フィールドに関連付けられているデータの種類の説明については、「解説」セクションを参照してください。

adwData[2]

2 つの DWORD 値の配列。 1 つの DWORD のみを使用する情報フィールドの場合、データは adwData [0] にあります。

データ

cbBuf: pBuf が指すバッファーのサイズをバイト単位で示します。
pBuf: フィールドの現在のデータを含むバッファーへのポインター。

注釈

Type メンバーがPRINTER_NOTIFY_TYPEを指定する場合、Field メンバーには次のいずれかの値を指定できます。

フィールド	データの種類	値
PRINTER_NOTIFY_FIELD_SERVER_NAME	サポートされていません。	0x00
PRINTER_NOTIFY_FIELD_PRINTER_NAME	pBuf は、プリンターの名前を含む null で終わる文字列へのポインターです。	0x01
PRINTER_NOTIFY_FIELD_SHARE_NAME	pBuf は、プリンターの共有ポイントを識別する null で終わる文字列へのポインターです。	0x02
PRINTER_NOTIFY_FIELD_PORT_NAME	pBuf は、印刷ジョブが出力されるポートの名前を含む null で終わる文字列へのポインターです。 [プリンタープール] が選択されている場合、これはポートのコンマ区切りの一覧です。	0x03
PRINTER_NOTIFY_FIELD_DRIVER_NAME	pBuf は、プリンターのドライバーの名前を含む null で終わる文字列へのポインターです。	0x04
PRINTER_NOTIFY_FIELD_COMMENT	pBuf は、新しいコメント文字列を含む null で終わる文字列へのポインターであり、通常はプリンターの簡単な説明です。	0x05
PRINTER_NOTIFY_FIELD_LOCATION	pBuf は、プリンターの新しい物理的な場所 ("ビル 38、会議室 1164" など) を含む null で終わる文字列へのポインターです。	0x06
PRINTER_NOTIFY_FIELD_DEVMODE	pBuf は、用紙の向きや解像度などの既定のプリンターデータを定義する DEVMODE 構造体へのポインターです。	0x07
PRINTER_NOTIFY_FIELD_SEPFILE	pBuf は、区切り文字ページの作成に使用されるファイルの名前を指定する null で終わる文字列へのポインターです。このページは、プリンターに送信される印刷ジョブを分離するために使用されます。	0x08
PRINTER_NOTIFY_FIELD_PRINT_PROCESSOR	pBuf は、プリンターで使用される印刷プロセッサの名前を指定する null で終わる文字列へのポインターです。	0x09
PRINTER_NOTIFY_FIELD_PARAMETERS	pBuf は、既定の印刷プロセッサパラメーターを指定する null で終わる文字列へのポインターです。	0x0A
PRINTER_NOTIFY_FIELD_DATATYPE	pBuf は、印刷ジョブの記録に使用されるデータ型を指定する null で終わる文字列へのポインターです。	0x0B
PRINTER_NOTIFY_FIELD_SECURITY_DESCRIPTOR	pBuf は、プリンターの SECURITY_DESCRIPTOR 構造体へのポインターです。セキュリティ記述子がない場合、ポインターは NULL になる可能性があります。	0x0C
PRINTER_NOTIFY_FIELD_ATTRIBUTES	adwData [0] はプリンター属性を指定します。プリンター属性には、次のいずれかの値を指定できます。 PRINTER_ATTRIBUTE_QUEUED PRINTER_ATTRIBUTE_DIRECT PRINTER_ATTRIBUTE_DEFAULT PRINTER_ATTRIBUTE_SHARED	0x0D
PRINTER_NOTIFY_FIELD_PRIORITY	adwData [0] は、スプーラーが印刷ジョブのルーティングに使用する優先度値を指定します。	0x0E
PRINTER_NOTIFY_FIELD_DEFAULT_PRIORITY	adwData [0] は、各印刷ジョブに割り当てられる既定の優先度値を指定します。	0x0F
PRINTER_NOTIFY_FIELD_START_TIME	adwData [0] は、プリンターがジョブを印刷する最も早い時刻を指定します。 (この値は、午前 12 時から経過した分単位で指定されます。	0x10
PRINTER_NOTIFY_FIELD_UNTIL_TIME	adwData [0] は、プリンターがジョブを印刷する最新時刻を指定します。 (この値は、午前 12 時から経過した分単位で指定されます。	0x11
PRINTER_NOTIFY_FIELD_STATUS	adwData [0] はプリンターの状態を指定します。使用可能な値の一覧については、 PRINTER_INFO_2 構造体を参照してください。	0x12
PRINTER_NOTIFY_FIELD_STATUS_STRING	サポートされていません。	0x13
PRINTER_NOTIFY_FIELD_CJOBS	adwData [0] は、プリンターのキューに入っている印刷ジョブの数を指定します。	0x14
PRINTER_NOTIFY_FIELD_AVERAGE_PPM	adwData [0] は、プリンターに印刷された 1 分あたりの平均ページ数を指定します。	0x15
PRINTER_NOTIFY_FIELD_TOTAL_PAGES	サポートされていません。	0x16
PRINTER_NOTIFY_FIELD_PAGES_PRINTED	サポートされていません。	0x17
PRINTER_NOTIFY_FIELD_TOTAL_BYTES	サポートされていません。	0x18
PRINTER_NOTIFY_FIELD_BYTES_PRINTED	サポートされていません。	0x19
PRINTER_NOTIFY_FIELD_OBJECT_GUID	これは、オブジェクト GUID が変更された場合に設定されます。	0x1A
PRINTER_NOTIFY_FIELD_FRIENDLY_NAME	これは、プリンター接続の名前が変更された場合に設定されます。	0x1B

Type メンバーがJOB_NOTIFY_TYPEを指定する場合、Field メンバーには次のいずれかの値を指定できます。

フィールド	データの種類	値
JOB_NOTIFY_FIELD_PRINTER_NAME	pBuf は、ジョブがスプールされるプリンターの名前を含む null で終わるストリングへのポインターです。	0x00
JOB_NOTIFY_FIELD_MACHINE_NAME	pBuf は、印刷ジョブを作成したマシンの名前を指定する null で終わる文字列へのポインターです。	0x01
JOB_NOTIFY_FIELD_PORT_NAME	pBuf は、データをプリンターに送信するために使用されるポートを識別する null で終わる文字列へのポインターです。プリンターが複数のポートに接続されている場合、ポートの名前はコンマで区切られます (例: "LPT1:,LPT2:,LPT3:")。	0x02
JOB_NOTIFY_FIELD_USER_NAME	pBuf は、印刷ジョブを送信したユーザーの名前を指定する null で終わる文字列へのポインターです。	0x03
JOB_NOTIFY_FIELD_NOTIFY_NAME	pBuf は、null で終わる文字列へのポインターであり、ジョブが印刷されたとき、またはジョブの印刷中にエラーが発生したときに通知を受け取るユーザーの名前を指定します。	0x04
JOB_NOTIFY_FIELD_DATATYPE	pBuf は、印刷ジョブの記録に使用されるデータの種類を指定する null で終わる文字列へのポインターです。	0x05
JOB_NOTIFY_FIELD_PRINT_PROCESSOR	pBuf は、ジョブの印刷に使用する印刷プロセッサの名前を指定する null で終わる文字列へのポインターです。	0x06
JOB_NOTIFY_FIELD_PARAMETERS	pBuf は、印刷プロセッサパラメーターを指定する null で終わる文字列へのポインターです。	0x07
JOB_NOTIFY_FIELD_DRIVER_NAME	pBuf は、印刷ジョブの処理に使用するプリンタードライバーの名前を指定する null で終わる文字列へのポインターです。	0x08
JOB_NOTIFY_FIELD_DEVMODE	pBuf は、プリンタードライバーのデバイス初期化と環境データを含む DEVMODE 構造体へのポインターです。	0x09
JOB_NOTIFY_FIELD_STATUS	adwData [0] はジョブの状態を指定します。使用可能な値の一覧については、 JOB_INFO_2 構造体を参照してください。	0x0A
JOB_NOTIFY_FIELD_STATUS_STRING	pBuf は、印刷ジョブの状態を指定する null で終わる文字列へのポインターです。	0x0B
JOB_NOTIFY_FIELD_SECURITY_DESCRIPTOR	サポートされていません。	0x0C
JOB_NOTIFY_FIELD_DOCUMENT	pBuf は、印刷ジョブの名前 ("MS-WORD: Review.doc" など) を指定する null で終わる文字列へのポインターです。	0x0D
JOB_NOTIFY_FIELD_PRIORITY	adwData [0] はジョブの優先順位を指定します。	0x0E
JOB_NOTIFY_FIELD_POSITION	adwData [0] は、印刷キュー内のジョブの位置を指定します。	0x0F
JOB_NOTIFY_FIELD_SUBMITTED	pBuf は、ジョブが送信された時刻を指定する SYSTEMTIME 構造体へのポインターです。	0x10
JOB_NOTIFY_FIELD_START_TIME	adwData [0] は、ジョブを印刷できる最も早い時刻を指定します。 (この値は、午前 12 時から経過した分単位で指定されます。	0x11
JOB_NOTIFY_FIELD_UNTIL_TIME	adwData [0] は、ジョブを印刷できる最新時刻を指定します。 (この値は、午前 12 時から経過した分単位で指定されます。	0x12
JOB_NOTIFY_FIELD_TIME	adwData [0] は、ジョブの印刷開始後に経過した合計時間を秒単位で指定します。	0x13
JOB_NOTIFY_FIELD_TOTAL_PAGES	adwData [0] は、ジョブのサイズをページ単位で指定します。	0x14
JOB_NOTIFY_FIELD_PAGES_PRINTED	adwData [0] は、印刷されたページ数を指定します。	0x15
JOB_NOTIFY_FIELD_TOTAL_BYTES	adwData [0] は、ジョブのサイズをバイト単位で指定します。	0x16
JOB_NOTIFY_FIELD_BYTES_PRINTED	adwData [0] は、このジョブに出力されたバイト数を指定します。このフィールドでは、変更通知オブジェクトは、バイトがプリンターに送信されるときに通知されます。	0x17

要件

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

次の方法で共有

PRINTER_NOTIFY_INFO_DATA構造体

構文

メンバー

注釈

要件

関連項目

フィードバック

その他のリソース