Fungsi GetDefaultPrinter

Fungsi GetDefaultPrinter mengambil nama printer dari printer default untuk pengguna saat ini di komputer lokal.

Sintaks

BOOL GetDefaultPrinter(
  _In_    LPTSTR  pszBuffer,
  _Inout_ LPDWORD pcchBuffer
);

Parameter

pszBuffer [in]

Penunjuk ke buffer yang menerima string karakter yang dihentikan null yang berisi nama printer default. Jika parameter ini ADALAH NULL, fungsi gagal dan variabel yang diacu oleh pcchBuffer mengembalikan ukuran buffer yang diperlukan, dalam karakter.

pcchBuffer [masuk, keluar]

Pada input, menentukan ukuran, dalam karakter, dari buffer pszBuffer . Pada output, menerima ukuran, dalam karakter, string nama printer, termasuk karakter null yang mengakhiri.

Nilai kembali

Jika fungsi berhasil, nilai yang dikembalikan adalah nilai bukan nol dan variabel yang diacu oleh pcchBuffer berisi jumlah karakter yang disalin ke buffer pszBuffer , termasuk karakter null yang mengakhiri.

Jika fungsi gagal, nilai yang dikembalikan adalah nol.

Nilai	Makna
ERROR_INSUFFICIENT_BUFFER	Buffer pszBuffer terlalu kecil. Variabel yang ditunjukkan oleh pcchBuffer berisi ukuran buffer yang diperlukan, dalam karakter.
ERROR_FILE_NOT_FOUND	Tidak ada pencetak default.

Keterangan

Catatan

Ini adalah fungsi pemblokiran atau sinkron dan mungkin tidak segera dikembalikan. 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.

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)
Pustaka	Winspool.lib
DLL	Winspool.drv
Nama Unicode dan ANSI	GetDefaultPrinterW (Unicode) dan GetDefaultPrinterA (ANSI)

Lihat juga

Pencetakan

Cetak Fungsi API Spooler

SetDefaultPrinter