Fungsi EnumPrintProcessorDatatypes
Fungsi EnumPrintProcessorDatatypes menghitung jenis data yang didukung prosesor cetak tertentu.
Sintaks
BOOL EnumPrintProcessorDatatypes(
_In_ LPTSTR pName,
_In_ LPTSTR pPrintProcessorName,
_In_ DWORD Level,
_Out_ LPBYTE pDatatypes,
_In_ DWORD cbBuf,
_Out_ LPDWORD pcbNeeded,
_Out_ LPDWORD pcReturned
);
Parameter
-
pName [in]
-
Penunjuk ke string yang dihentikan null yang menentukan nama server tempat prosesor cetak berada. Jika parameter ini NULL, jenis data untuk prosesor cetak lokal dijumlahkan.
-
pPrintProcessorName [in]
-
Penunjuk ke string yang dihentikan null yang menentukan nama prosesor cetak yang jenis datanya dijumlahkan.
-
Level [in]
-
Jenis informasi yang dikembalikan dalam buffer pDatatypes . Parameter ini harus 1.
-
pDatatypes [out]
-
Penunjuk ke buffer yang menerima array struktur DATATYPES_INFO_1 . Setiap struktur menjelaskan jenis data yang tersedia. Buffer harus cukup besar untuk menerima array struktur dan string apa pun atau data lain yang menjadi titik anggota struktur.
Untuk menentukan ukuran buffer yang diperlukan, panggil EnumPrintProcessorDatatypes dengan cbBuf diatur ke nol. EnumPrintProcessorDatatypes gagal, GetLastError mengembalikan ERROR_INSUFFICIENT_BUFFER, dan parameter pcbNeeded mengembalikan ukuran, dalam byte, dari buffer yang diperlukan untuk menahan array struktur dan datanya.
-
cbBuf [in]
-
Ukuran, dalam byte, dari buffer yang diacu oleh pDatatypes.
-
pcbNeeded [out]
-
Pointer ke variabel yang menerima jumlah byte yang disalin ke buffer pDatatypes jika fungsi berhasil. Jika buffer terlalu kecil, fungsi gagal dan variabel menerima jumlah byte yang diperlukan.
-
pcReturned [out]
-
Penunjuk ke variabel yang menerima jumlah struktur yang dikembalikan dalam buffer pDatatypes . Ini adalah jumlah jenis data yang didukung.
Mengembalikan nilai
Jika fungsi berhasil, nilai yang dikembalikan adalah nilai bukan nol.
Jika fungsi gagal, nilai yang dikembalikan adalah nol.
Keterangan
Catatan
Ini adalah fungsi pemblokiran atau sinkron dan mungkin tidak segera kembali. Seberapa cepat fungsi ini kembali tergantung pada faktor run-time seperti status jaringan, konfigurasi server cetak, dan faktor implementasi driver printer yang sulit diprediksi saat menulis aplikasi. Memanggil fungsi ini dari utas yang mengelola interaksi dengan antarmuka pengguna dapat membuat aplikasi tampak tidak responsif.
v
Dimulai dengan Windows Vista, informasi tipe data dari server cetak jarak jauh diambil dari cache lokal.
Persyaratan
Persyaratan | Nilai |
---|---|
Klien minimum yang didukung |
Windows 2000 Professional [hanya aplikasi desktop] |
Server minimum yang didukung |
Windows 2000 Server [hanya aplikasi desktop] |
Header |
|
Pustaka |
|
DLL |
|
Nama Unicode dan ANSI |
EnumPrintProcessorDatatypesW (Unicode) dan EnumPrintProcessorDatatypesA (ANSI) |
Lihat juga
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk