struktur PRINTER_INFO_7

Artikel
06/13/2023

Struktur PRINTER_INFO_7 menentukan informasi printer layanan direktori. Gunakan struktur ini dengan fungsi SetPrinter untuk menerbitkan data printer di layanan direktori (DS), atau untuk memperbarui atau menghapus data printer yang diterbitkan dari DS. Gunakan struktur ini dengan fungsi GetPrinter untuk menentukan apakah printer diterbitkan di DS.

Sintaks

typedef struct _PRINTER_INFO_7 {
  LPTSTR pszObjectGUID;
  DWORD  dwAction;
} PRINTER_INFO_7, *PPRINTER_INFO_7;

Anggota

pszObjectGUID

Penunjuk ke string yang dihentikan null yang berisi GUID objek antrean cetak layanan direktori yang terkait dengan printer yang diterbitkan. Gunakan fungsi GetPrinter untuk mengambil GUID ini.

Sebelum memanggil SetPrinter, atur pszObjectGUID ke NULL.

dwAction

Menunjukkan tindakan untuk fungsi SetPrinter yang akan dilakukan. Untuk fungsi GetPrinter , anggota ini menunjukkan apakah printer yang ditentukan diterbitkan. Anggota ini bisa menjadi kombinasi dari nilai berikut.

Nilai	Makna
DSPRINT_PENDING 0x80000000	GetPrinter: Menunjukkan bahwa sistem mencoba menyelesaikan operasi penerbitan atau pembatalan penerbitan yang dimulai oleh panggilan SetPrinter . SetPrinter: Nilai ini tidak valid.
DSPRINT_PUBLISH 0x00000001	SetPrinter: Menerbitkan data printer di DS. GetPrinter: Menunjukkan printer diterbitkan.
DSPRINT_REPUBLISH 0x00000008	SetPrinter: Data DS untuk printer tidak diterbitkan dan kemudian diterbitkan lagi, menyegarkan semua properti di printer yang diterbitkan. Menerbitkan ulang juga mengubah GUID printer yang diterbitkan. GetPrinter: Tidak pernah mengembalikan nilai ini.
DSPRINT_UNPUBLISH 0x00000004	SetPrinter: Menghapus data printer yang diterbitkan dari DS. GetPrinter: Menunjukkan printer tidak diterbitkan.
DSPRINT_UPDATE 0x00000002	SetPrinter: Updates data printer yang diterbitkan di DS. GetPrinter: Tidak pernah mengembalikan nilai ini.

Keterangan

Struktur PRINTER_INFO_7 digunakan dalam panggilan SetPrinter untuk menerbitkan informasi printer ke layanan direktori. Data yang diterbitkan mencakup semua nilai dan data untuk printer tertentu yang ditemukan di bawah kunci SPLDS_SPOOLER_KEY, SPLDS_DRIVER_KEY, atau SPLDS_USER_KEY yang dibuat oleh SetPrinterDataEx.

Untuk SetPrinter, pszObjectGUID harus diatur ke NULL. Untuk GetPrinter, pszObjectGUID mengembalikan GUID objek antrean cetak layanan direktori yang terkait dengan printer yang diterbitkan. Anda dapat menggunakan GUID ini dengan metode Antarmuka Layanan Direktori Aktif (ADSI) untuk mengambil data yang diterbitkan untuk printer. Namun, metode yang direkomendasikan untuk mengambil data yang diterbitkan adalah dengan memanggil fungsi GetPrinterDataEx .

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_7W (Unicode) dan _PRINTER_INFO_7A (ANSI)

Lihat juga

Pencetakan
Cetak Struktur API Spooler

Bagikan melalui