struktur PRINTER_INFO_4

Struktur PRINTER_INFO_4 menentukan informasi printer umum.

Struktur dapat digunakan untuk mengambil informasi printer minimal pada panggilan ke EnumPrinters. Panggilan seperti itu adalah cara cepat dan mudah untuk mengambil nama dan atribut semua printer yang diinstal secara lokal pada sistem dan semua koneksi printer jarak jauh yang telah dibuat pengguna.

Sintaks

typedef struct _PRINTER_INFO_4 {
  LPTSTR pPrinterName;
  LPTSTR pServerName;
  DWORD  Attributes;
} PRINTER_INFO_4, *PPRINTER_INFO_4;

Anggota

pPrinterName

Penunjuk ke string yang dihentikan null yang menentukan nama printer (lokal atau jarak jauh).

pServerName

Penunjuk ke string yang dihentikan null yang merupakan nama server.

Atribut

Menentukan informasi tentang data yang dikembalikan.

Nilai	Makna
PRINTER_ATTRIBUTE_LOCAL	Pencetak adalah pencetak lokal.
PRINTER_ATTRIBUTE_NETWORK	Pencetak adalah pencetak jarak jauh.

Keterangan

Struktur PRINTER_INFO_4 menyediakan cara yang mudah dan sangat cepat untuk mengambil nama printer yang diinstal pada komputer lokal, serta koneksi jarak jauh yang telah dibuat pengguna. Saat EnumPrinters dipanggil dengan struktur data PRINTER_INFO_4 , fungsi tersebut meminta registri untuk informasi yang ditentukan, lalu segera kembali. Ini berbeda dari perilaku EnumPrinters ketika dipanggil dengan tingkat struktur data PRINTER_INFO_xxx lainnya. Secara khusus, ketika EnumPrinters dipanggil dengan struktur data tingkat 2 (PRINTER_INFO_2 ), enumPrinter melakukan panggilan OpenPrinter pada setiap koneksi jarak jauh. Jika koneksi jarak jauh tidak berfungsi, jika server jarak jauh tidak ada lagi, atau jika printer jarak jauh tidak ada lagi, fungsi harus menunggu RPC kehabisan waktu dan akibatnya gagal dalam panggilan OpenPrinter . Ini bisa memakan waktu cukup lama. Melewati struktur PRINTER_INFO_4 memungkinkan aplikasi mengambil informasi minimum yang diperlukan; jika informasi lebih rinci diinginkan, panggilan EnumPrinter level 2 berikutnya dapat dilakukan.

Atribut juga dapat berisi nilai yang ditentukan dalam bidang AtributPRINTER_INFO_2.

Beberapa konfigurasi printer, seperti koneksi printer ke beberapa server cetak berbasis non-Windows, mungkin mengembalikan PRINTER_ATTRIBUTE_LOCAL dan PRINTER_ATTRIBUTE_NETWORK.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Header	Winspool.h (termasuk Windows.h)
Nama Unicode dan ANSI	_PRINTER_INFO_4W (Unicode) dan _PRINTER_INFO_4A (ANSI)

Lihat juga

Pencetakan

Cetak Struktur API Spooler

GetPrinter

EnumPrinters

OpenPrinter

PRINTER_INFO_1

PRINTER_INFO_2

PRINTER_INFO_3