struktur PRINTER_INFO_2

Artikel
06/12/2023

Struktur PRINTER_INFO_2 menentukan informasi printer terperinci.

Sintaks

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;

Anggota

pServerName

Penunjuk ke string yang dihentikan null yang mengidentifikasi server yang mengontrol printer. Jika string ini NULL, pencetak dikontrol secara lokal.

pPrinterName

Penunjuk ke string yang dihentikan null yang menentukan nama printer.

pShareName

Penunjuk ke string yang dihentikan null yang mengidentifikasi titik berbagi untuk printer. (String ini hanya digunakan jika konstanta PRINTER_ATTRIBUTE_SHARED diatur untuk anggota Atribut.)

pPortName

Penunjuk ke string yang dihentikan null yang mengidentifikasi port yang digunakan untuk mengirimkan data ke printer. Jika printer tersambung ke lebih dari satu port, nama setiap port harus dipisahkan dengan koma (misalnya, "LPT1:,LPT2:,LPT3:").

pDriverName

Penunjuk ke string yang dihentikan null yang menentukan nama pengandar printer.

pComment

Penunjuk ke string yang dihentikan null yang memberikan deskripsi singkat tentang printer.

pLokasi

Penunjuk ke string yang dihentikan null yang menentukan lokasi fisik printer (misalnya, "Bldg. 38, Ruangan 1164").

pDevMode

Penunjuk ke struktur DEVMODE yang menentukan data printer default seperti orientasi kertas dan resolusi.

pSepFile

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.

pPrintProcessor

Penunjuk ke string yang dihentikan null yang menentukan nama prosesor cetak yang digunakan oleh printer. Anda dapat menggunakan fungsi EnumPrintProcessors untuk mendapatkan daftar prosesor cetak yang diinstal pada server.

pDatatype

Penunjuk ke string yang dihentikan null yang menentukan jenis data yang digunakan untuk merekam pekerjaan cetak. Anda dapat menggunakan fungsi EnumPrintProcessorDatatypes untuk mendapatkan daftar jenis data yang didukung oleh prosesor cetak tertentu.

pParameters

Penunjuk ke string yang dihentikan null yang menentukan parameter prosesor cetak default.

pSecurityDescriptor

Penunjuk ke struktur SECURITY_DESCRIPTOR untuk printer. Anggota ini mungkin NULL.

Atribut

Atribut printer. Anggota ini bisa menjadi kombinasi yang wajar dari nilai berikut.

Nilai	Makna
PRINTER_ATTRIBUTE_DIRECT	Pekerjaan dikirim langsung ke pencetak (tidak tertampung).
PRINTER_ATTRIBUTE_DO_COMPLETE_FIRST	Jika set dan printer diatur untuk print-while-spooling, pekerjaan apa pun yang telah selesai menampung dijadwalkan untuk mencetak sebelum pekerjaan yang belum selesai menampung.
PRINTER_ATTRIBUTE_ENABLE_DEVQ	Jika diatur, DevQueryPrint dipanggil. DevQueryPrint mungkin gagal jika penyetelan dokumen dan printer tidak cocok. Mengatur bendera ini menyebabkan dokumen yang tidak cocok ditahan dalam antrean.
PRINTER_ATTRIBUTE_HIDDEN	Dicadangkan.
PRINTER_ATTRIBUTE_KEEPPRINTEDJOBS	Jika diatur, pekerjaan disimpan setelah dicetak. Jika tidak diatur, pekerjaan akan dihapus.
PRINTER_ATTRIBUTE_LOCAL	Printer adalah printer lokal.
PRINTER_ATTRIBUTE_NETWORK	Printer adalah koneksi printer jaringan.
PRINTER_ATTRIBUTE_PUBLISHED	Menunjukkan apakah pencetak diterbitkan di layanan direktori.
PRINTER_ATTRIBUTE_QUEUED	Jika disetel, printer akan tertampung dan mulai mencetak setelah halaman terakhir ditampung. Jika tidak diatur dan PRINTER_ATTRIBUTE_DIRECT tidak disetel, printer akan terkurung dan mencetak saat menampung.
PRINTER_ATTRIBUTE_RAW_ONLY	Menunjukkan bahwa hanya pekerjaan cetak jenis data mentah yang dapat ditampung.
PRINTER_ATTRIBUTE_SHARED	Printer dibagikan.

Di Windows XP dan versi Windows yang lebih baru, nilai berikut juga dapat digunakan.

Nilai	Makna
PRINTER_ATTRIBUTE_FAX	Jika disetel, printer adalah pencetak faks. Ini hanya dapat diatur oleh AddPrinter, tetapi dapat diambil oleh EnumPrinters dan GetPrinter.

Di Windows Vista dan versi Windows yang lebih baru, nilai berikut ini juga dapat digunakan.

Nilai	Makna
PRINTER_ATTRIBUTE_FRIENDLY_NAME	Komputer telah tersambung ke pencetak ini dan memberinya nama yang mudah diingat.
PRINTER_ATTRIBUTE_MACHINE	Printer adalah koneksi per komputer.
PRINTER_ATTRIBUTE_PUSHED_USER	Pencetak diinstal dengan menggunakan kebijakan pengguna Sambungan Pencetak Pendorongan.
PRINTER_ATTRIBUTE_PUSHED_MACHINE	Pencetak diinstal dengan menggunakan kebijakan komputer Sambungan Pencetak Pendorongan.

Di Windows Server 2003, nilai berikut juga dapat digunakan.

Nilai	Makna
PRINTER_ATTRIBUTE_TS	Menunjukkan pencetak saat ini tersambung melalui server terminal.

Prioritas

Nilai prioritas yang digunakan penampung untuk merutekan pekerjaan cetak.

DefaultPriority

Nilai prioritas default yang ditetapkan untuk setiap pekerjaan cetak.

StartTime

Waktu paling awal di mana pencetak akan mencetak pekerjaan. Nilai ini dinyatakan sebagai menit yang berlalu sejak pukul 12:00 GMT (Greenwich Mean Time).

UntilTime

Waktu terbaru pencetak akan mencetak pekerjaan. Nilai ini dinyatakan sebagai menit yang berlalu sejak pukul 12:00 GMT (Greenwich Mean Time).

Status

Status printer. Anggota ini bisa menjadi kombinasi yang wajar dari nilai berikut.

Nilai	Makna
PRINTER_STATUS_BUSY	Pencetak sibuk.
PRINTER_STATUS_DOOR_OPEN	Pintu printer terbuka.
PRINTER_STATUS_ERROR	Pencetak dalam keadaan galat.
PRINTER_STATUS_INITIALIZING	Pencetak sedang menginisialisasi.
PRINTER_STATUS_IO_ACTIVE	Printer dalam status input/output aktif
PRINTER_STATUS_MANUAL_FEED	Pencetak dalam status umpan manual.
PRINTER_STATUS_NO_TONER	Pencetak kehabisan toner.
PRINTER_STATUS_NOT_AVAILABLE	Pencetak tidak tersedia untuk pencetakan.
PRINTER_STATUS_OFFLINE	Pencetak sedang offline.
PRINTER_STATUS_OUT_OF_MEMORY	Pencetak kehabisan memori.
PRINTER_STATUS_OUTPUT_BIN_FULL	Bin output printer penuh.
PRINTER_STATUS_PAGE_PUNT	Pencetak tidak dapat mencetak halaman saat ini.
PRINTER_STATUS_PAPER_JAM	Kertas macet di printer
PRINTER_STATUS_PAPER_OUT	Pencetak kehabisan kertas.
PRINTER_STATUS_PAPER_PROBLEM	Pencetak bermasalah pada kertas.
PRINTER_STATUS_PAUSED	Pencetak dijeda.
PRINTER_STATUS_PENDING_DELETION	Pencetak sedang dihapus.
PRINTER_STATUS_POWER_SAVE	Pencetak dalam mode hemat daya.
PRINTER_STATUS_PRINTING	Pencetak sedang mencetak.
PRINTER_STATUS_PROCESSING	Pencetak sedang memproses tugas cetak.
PRINTER_STATUS_SERVER_UNKNOWN	Status pencetak tidak diketahui.
PRINTER_STATUS_TONER_LOW	Pencetak hampir kehabisan toner.
PRINTER_STATUS_USER_INTERVENTION	Pencetak memiliki kesalahan yang mengharuskan pengguna untuk melakukan sesuatu.
PRINTER_STATUS_WAITING	Pencetak sedang menunggu.
PRINTER_STATUS_WARMING_UP	Pencetak sedang melakukan pemanasan.

cJobs

Jumlah tugas cetak yang telah diantrekan untuk pencetak.

AveragePPM

Jumlah rata-rata halaman per menit yang telah dicetak pada printer.

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_2W (Unicode) dan _PRINTER_INFO_2A (ANSI)

Lihat juga

Pencetakan
Cetak Struktur API Spooler
DEVMODE
EnumPrinters
PRINTER_INFO_1
PRINTER_INFO_3
PRINTER_INFO_4
SECURITY_DESCRIPTOR

Bagikan melalui

struktur PRINTER_INFO_2

Sintaks

Anggota

Persyaratan

Lihat juga

Saran dan Komentar

Sumber Daya Tambahan: