Fungsi EngSetPrinterData (winddi.h)

Artikel
08/27/2023

Fungsi EngSetPrinterData kedaluarsa di Windows 2000 dan yang lebih baru.

Di versi Windows EngSetPrinterData yang lebih lama mengatur data konfigurasi untuk printer yang ditentukan.

Sintaks

ENGAPI DWORD EngSetPrinterData(
  [in] HANDLE hPrinter,
  [in] LPWSTR pType,
  [in] DWORD  dwType,
  [in] LPBYTE lpbPrinterData,
  [in] DWORD  cjPrinterData
);

Parameter

[in] hPrinter

Tangani ke printer yang data konfigurasinya harus diatur. Ini adalah handel yang diteruskan sebagai parameter hDriverdrvEnablePDEV. Lihat Keterangan.

[in] pType

Penunjuk ke string yang dihentikan null yang mengidentifikasi data yang akan diatur.

[in] dwType

Adalah bendera yang menentukan jenis informasi yang akan diatur. Parameter ini bisa menjadi salah satu nilai berikut:

Nilai	Makna
REG_BINARY	Data biner dalam bentuk apa pun.
REG_DWORD	Angka 32-bit.
REG_DWORD_BIG_ENDIAN	Angka 32-bit dalam format big-endian, yang berarti bahwa byte kata yang paling signifikan adalah byte urutan rendah.
REG_DWORD_LITTLE_ENDIAN	Angka 32-bit dalam format little-endian (sama seperti REG_DWORD), yang berarti bahwa byte kata yang paling signifikan adalah byte urutan tinggi
REG_EXPAND_SZ	String yang dihentikan null yang berisi referensi yang tidak terluaskan ke variabel lingkungan (misalnya, "%PATH%"). Ini akan menjadi string Unicode atau ANSI tergantung pada apakah fungsi Unicode atau ANSI digunakan.
REG_LINK	Tautan simbolis Unicode.
REG_MULTI_SZ	Array string yang dihentikan null, dihentikan oleh dua karakter null.
REG_NONE	Tidak ada jenis nilai yang ditentukan.
REG_RESOURCE_LIST	Daftar sumber daya pengandar perangkat.
REG_SZ	String yang dihentikan null. Ini akan menjadi string Unicode atau ANSI tergantung pada apakah Anda menggunakan fungsi Unicode atau ANSI.

[in] lpbPrinterData

Arahkan ke data konfigurasi printer yang akan diatur. Jenis data yang diarahkan ke ditentukan oleh dwType.

[in] cjPrinterData

Menentukan ukuran, dalam byte, dari lpbPrinterData.

Mengembalikan nilai

EngSetPrinterData mengembalikan pesan kesalahan terakhir yang dicatat.

Keterangan

Dimulai dengan Microsoft Windows 2000, fungsi ini kedaluarsa. Handel yang digunakan dalam panggilan ke fungsi EngSetPrinterData dan DrvEnablePDEV memiliki hak akses yang berbeda; oleh karena itu fungsi-fungsi ini tidak lagi bekerja sama. Parameter hDriver yang digunakan dalam panggilan ke fungsi DrvEnablePDEV dibuka dengan hak akses PRINTER_ACCESS_USE. Sebaliknya, parameter hPrinter yang digunakan dalam panggilan ke fungsi EngSetPrinterData harus dibuka dengan hak akses PRINTER_ALL_ACCESS. Akibatnya, tidak ada cara bagi driver printer mode kernel (satu-satunya jenis driver printer yang dapat memanggil EngSetPrinterData) untuk menggunakan EngSetPrinterData untuk menulis informasi tentang printer ke registri.

Untuk informasi selengkapnya tentang hak akses printer, lihat struktur PRINTER_DEFAULTS (dijelaskan dalam dokumentasi Windows SDK).

Persyaratan


Klien minimum yang didukung	Tersedia di Windows 2000 dan versi yang lebih baru dari sistem operasi Windows.
Target Platform	Universal
Header	winddi.h (termasuk Winddi.h)
Pustaka	Win32k.lib
DLL	Win32k.sys

Lihat juga

DrvEnablePDEV

EngGetPrinterData

Bagikan melalui