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