struktur PRINTER_NOTIFY_INFO_DATA
Struktur PRINTER_NOTIFY_INFO_DATA mengidentifikasi bidang informasi pekerjaan atau printer dan menyediakan data saat ini untuk bidang tersebut.
Fungsi FindNextPrinterChangeNotification mengembalikan struktur PRINTER_NOTIFY_INFO , yang berisi array struktur PRINTER_NOTIFY_INFO_DATA .
Sintaks
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; ;
Anggota
-
Jenis
-
Menunjukkan jenis informasi yang disediakan. Anggota ini bisa menjadi salah satu nilai berikut.
Nilai Makna - JOB_NOTIFY_TYPE
- 0x01
Menunjukkan bahwa anggota Bidang menentukan konstanta JOB_NOTIFY_FIELD_*. - PRINTER_NOTIFY_TYPE
- 0x00
Menunjukkan bahwa anggota Bidang menentukan konstanta PRINTER_NOTIFY_FIELD_*. -
Bidang
-
Menunjukkan bidang yang berubah. Untuk daftar nilai yang mungkin, lihat bagian Keterangan.
-
Dipesan
-
Dicadangkan.
-
Id
-
Menunjukkan pengidentifikasi pekerjaan jika anggota Jenis menentukan JOB_NOTIFY_TYPE. Jika anggota Tipe menentukan PRINTER_NOTIFY_TYPE, anggota ini tidak terdefinisi.
-
NotifyData
-
Penyatuan informasi data berdasarkan anggota Tipe dan Bidang . Untuk deskripsi jenis data yang terkait dengan setiap bidang, lihat bagian Keterangan.
-
adwData[2]
-
Array dua nilai DWORD . Untuk bidang informasi yang hanya menggunakan satu DWORD, data berada di adwData [0].
-
Data
-
-
cbBuf
-
Menunjukkan ukuran, dalam byte, dari buffer yang ditunjukkan oleh pBuf.
-
pBuf
-
Penunjuk ke buffer yang berisi data bidang saat ini.
-
-
Keterangan
Jika anggota Jenis menentukan PRINTER_NOTIFY_TYPE, anggota Bidang bisa menjadi salah satu nilai berikut.
| Bidang | Tipe data | Nilai |
|---|---|---|
| PRINTER_NOTIFY_FIELD_SERVER_NAME | Tidak didukung. | 0x00 |
| PRINTER_NOTIFY_FIELD_PRINTER_NAME | pBuf adalah penunjuk ke string yang dihentikan null yang berisi nama printer. | 0x01 |
| PRINTER_NOTIFY_FIELD_SHARE_NAME | pBuf adalah penunjuk ke string yang dihentikan null yang mengidentifikasi titik berbagi untuk printer. | 0x02 |
| PRINTER_NOTIFY_FIELD_PORT_NAME | pBuf adalah penunjuk ke string yang dihentikan null yang berisi nama port tempat pekerjaan cetak akan dicetak. Jika "Kumpulan Printer" dipilih, ini adalah daftar port yang dipisahkan koma. | 0x03 |
| PRINTER_NOTIFY_FIELD_DRIVER_NAME | pBuf adalah penunjuk ke string yang dihentikan null yang berisi nama driver printer. | 0x04 |
| PRINTER_NOTIFY_FIELD_COMMENT | pBuf adalah penunjuk ke string yang dihentikan null yang berisi string komentar baru, yang biasanya merupakan deskripsi singkat printer. | 0x05 |
| PRINTER_NOTIFY_FIELD_LOCATION | pBuf adalah penunjuk ke string null-terminated yang berisi lokasi fisik baru printer (misalnya, "Bldg. 38, Room 1164"). | 0x06 |
| PRINTER_NOTIFY_FIELD_DEVMODE | pBuf adalah penunjuk ke struktur DEVMODE yang menentukan data printer default seperti orientasi kertas dan resolusi. | 0x07 |
| PRINTER_NOTIFY_FIELD_SEPFILE | pBuf adalah penunjuk ke string yang dihentikan null yang menentukan nama file yang digunakan untuk membuat halaman pemisah. Halaman ini digunakan untuk memisahkan tugas cetak yang dikirim ke pencetak. | 0x08 |
| PRINTER_NOTIFY_FIELD_PRINT_PROCESSOR | pBuf adalah penunjuk ke string yang dihentikan null yang menentukan nama prosesor cetak yang digunakan oleh printer. | 0x09 |
| PRINTER_NOTIFY_FIELD_PARAMETERS | pBuf adalah penunjuk ke string yang dihentikan null yang menentukan parameter prosesor cetak default. | 0x0A |
| PRINTER_NOTIFY_FIELD_DATATYPE | pBuf adalah penunjuk ke string yang dihentikan null yang menentukan jenis data yang digunakan untuk merekam pekerjaan cetak. | 0x0B |
| PRINTER_NOTIFY_FIELD_SECURITY_DESCRIPTOR | pBuf adalah penunjuk ke struktur SECURITY_DESCRIPTOR untuk printer. Penunjuk mungkin NULL jika tidak ada deskriptor keamanan. | 0x0C |
| PRINTER_NOTIFY_FIELD_ATTRIBUTES |
adwData [0] menentukan atribut printer, yang dapat menjadi salah satu nilai berikut:
PRINTER_ATTRIBUTE_DIRECT PRINTER_ATTRIBUTE_DEFAULT PRINTER_ATTRIBUTE_SHARED |
0x0D |
| PRINTER_NOTIFY_FIELD_PRIORITY | adwData [0] menentukan nilai prioritas yang digunakan penampung untuk merutekan pekerjaan cetak. | 0x0E |
| PRINTER_NOTIFY_FIELD_DEFAULT_PRIORITY | adwData [0] menentukan nilai prioritas default yang ditetapkan untuk setiap pekerjaan cetak. | 0x0F |
| PRINTER_NOTIFY_FIELD_START_TIME | adwData [0] menentukan waktu paling awal di mana printer akan mencetak pekerjaan. (Nilai ini ditentukan dalam menit yang berlalu sejak pukul 12:00 A.M.) | 0x10 |
| PRINTER_NOTIFY_FIELD_UNTIL_TIME | adwData [0] menentukan waktu terbaru di mana printer akan mencetak pekerjaan. (Nilai ini ditentukan dalam menit yang berlalu sejak pukul 12:00 A.M.) | 0x11 |
| PRINTER_NOTIFY_FIELD_STATUS | adwData [0] menentukan status printer. Untuk daftar nilai yang mungkin, lihat struktur PRINTER_INFO_2 . | 0x12 |
| PRINTER_NOTIFY_FIELD_STATUS_STRING | Tidak didukung. | 0x13 |
| PRINTER_NOTIFY_FIELD_CJOBS | adwData [0] menentukan jumlah pekerjaan cetak yang telah diantrekan untuk printer. | 0x14 |
| PRINTER_NOTIFY_FIELD_AVERAGE_PPM | adwData [0] menentukan jumlah rata-rata halaman per menit yang telah dicetak pada printer. | 0x15 |
| PRINTER_NOTIFY_FIELD_TOTAL_PAGES | Tidak didukung. | 0x16 |
| PRINTER_NOTIFY_FIELD_PAGES_PRINTED | Tidak didukung. | 0x17 |
| PRINTER_NOTIFY_FIELD_TOTAL_BYTES | Tidak didukung. | 0x18 |
| PRINTER_NOTIFY_FIELD_BYTES_PRINTED | Tidak didukung. | 0x19 |
| PRINTER_NOTIFY_FIELD_OBJECT_GUID | Ini diatur jika GUID objek berubah. | 0x1A |
| PRINTER_NOTIFY_FIELD_FRIENDLY_NAME | Ini diatur jika sambungan pencetak diganti namanya. | 0x1B |
Jika anggota Tipe menentukan JOB_NOTIFY_TYPE, anggota Bidang bisa menjadi salah satu nilai berikut.
| Bidang | Tipe data | Nilai |
|---|---|---|
| JOB_NOTIFY_FIELD_PRINTER_NAME | pBuf adalah penunjuk ke string yang dihentikan null yang berisi nama printer tempat pekerjaan ditampung. | 0x00 |
| JOB_NOTIFY_FIELD_MACHINE_NAME | pBuf adalah penunjuk ke string yang dihentikan null yang menentukan nama komputer yang membuat pekerjaan cetak. | 0x01 |
| JOB_NOTIFY_FIELD_PORT_NAME | pBuf adalah penunjuk ke string null-terminated yang mengidentifikasi port yang digunakan untuk mengirimkan data ke printer. Jika printer tersambung ke lebih dari satu port, nama port dipisahkan oleh koma (misalnya, "LPT1:,LPT2:,LPT3:"). | 0x02 |
| JOB_NOTIFY_FIELD_USER_NAME | pBuf adalah penunjuk ke string yang dihentikan null yang menentukan nama pengguna yang mengirim pekerjaan cetak. | 0x03 |
| JOB_NOTIFY_FIELD_NOTIFY_NAME | pBuf adalah penunjuk ke string yang dihentikan null yang menentukan nama pengguna yang harus diberi tahu ketika pekerjaan telah dicetak atau ketika kesalahan terjadi saat mencetak pekerjaan. | 0x04 |
| JOB_NOTIFY_FIELD_DATATYPE | pBuf adalah penunjuk ke string yang dihentikan null yang menentukan jenis data yang digunakan untuk merekam pekerjaan cetak. | 0x05 |
| JOB_NOTIFY_FIELD_PRINT_PROCESSOR | pBuf adalah penunjuk ke string null-terminated yang menentukan nama prosesor cetak yang akan digunakan untuk mencetak pekerjaan. | 0x06 |
| JOB_NOTIFY_FIELD_PARAMETERS | pBuf adalah penunjuk ke string null-terminated yang menentukan parameter print-processor. | 0x07 |
| JOB_NOTIFY_FIELD_DRIVER_NAME | pBuf adalah penunjuk ke string null-terminated yang menentukan nama driver printer yang harus digunakan untuk memproses pekerjaan cetak. | 0x08 |
| JOB_NOTIFY_FIELD_DEVMODE | pBuf adalah penunjuk ke struktur DEVMODE yang berisi data inisialisasi perangkat dan lingkungan untuk driver printer. | 0x09 |
| JOB_NOTIFY_FIELD_STATUS | adwData [0] menentukan status pekerjaan. Untuk daftar nilai yang mungkin, lihat struktur JOB_INFO_2 . | 0x0A |
| JOB_NOTIFY_FIELD_STATUS_STRING | pBuf adalah penunjuk ke string null-terminated yang menentukan status pekerjaan cetak. | 0x0B |
| JOB_NOTIFY_FIELD_SECURITY_DESCRIPTOR | Tidak didukung. | 0x0C |
| JOB_NOTIFY_FIELD_DOCUMENT | pBuf adalah penunjuk ke string null-terminated yang menentukan nama pekerjaan cetak (misalnya, "MS-WORD: Review.doc"). | 0x0D |
| JOB_NOTIFY_FIELD_PRIORITY | adwData [0] menentukan prioritas pekerjaan. | 0x0E |
| JOB_NOTIFY_FIELD_POSITION | adwData [0] menentukan posisi pekerjaan dalam antrean cetak. | 0x0F |
| JOB_NOTIFY_FIELD_SUBMITTED | pBuf adalah penunjuk ke struktur SYSTEMTIME yang menentukan waktu ketika pekerjaan dikirimkan. | 0x10 |
| JOB_NOTIFY_FIELD_START_TIME | adwData [0] menentukan waktu paling awal pekerjaan dapat dicetak. (Nilai ini ditentukan dalam menit yang berlalu sejak pukul 12:00 A.M.) | 0x11 |
| JOB_NOTIFY_FIELD_UNTIL_TIME | adwData [0] menentukan waktu terbaru pekerjaan dapat dicetak. (Nilai ini ditentukan dalam menit yang berlalu sejak pukul 12:00 A.M.) | 0x12 |
| JOB_NOTIFY_FIELD_TIME | adwData [0] menentukan total waktu, dalam detik, yang telah berlalu sejak pekerjaan mulai mencetak. | 0x13 |
| JOB_NOTIFY_FIELD_TOTAL_PAGES | adwData [0] menentukan ukuran, di halaman, pekerjaan. | 0x14 |
| JOB_NOTIFY_FIELD_PAGES_PRINTED | adwData [0] menentukan jumlah halaman yang telah dicetak. | 0x15 |
| JOB_NOTIFY_FIELD_TOTAL_BYTES | adwData [0] menentukan ukuran, dalam byte, dari pekerjaan. | 0x16 |
| JOB_NOTIFY_FIELD_BYTES_PRINTED | adwData [0] menentukan jumlah byte yang telah dicetak pada pekerjaan ini. Untuk bidang ini, objek pemberitahuan perubahan disinyalir ketika byte dikirim ke printer. | 0x17 |
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung |
Windows 2000 Professional [hanya aplikasi desktop] |
| Server minimum yang didukung |
Windows 2000 Server [hanya aplikasi desktop] |
| Header |
|