struktur PRINTER_INFO_2

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