Share via

struktur PRINTER_INFO_7

  • Artikel

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