Fungsi SetDefaultPrinter
Fungsi SetDefaultPrinter mengatur nama printer dari printer default untuk pengguna saat ini di komputer lokal.
Sintaks
BOOL SetDefaultPrinter(
_In_ LPCTSTR pszPrinter
);
Parameter
-
pszPrinter [in]
-
Penunjuk ke string yang dihentikan null yang berisi nama printer default. Untuk koneksi printer jarak jauh, format namanya adalah **\\server\**printername. Untuk printer lokal, format namanya adalah printername.
Jika parameter ini adalah NULL atau string kosong, yaitu, "", SetDefaultPrinter akan memilih printer default dari salah satu printer yang diinstal. Jika printer default sudah ada, memanggil SetDefaultPrinter dengan NULL atau string kosong dalam parameter ini dapat mengubah printer default.
Menampilkan nilai
Jika fungsi berhasil, nilai yang dikembalikan adalah nilai bukan nol.
Jika fungsi gagal, nilai yang dikembalikan adalah nol.
Keterangan
Ketika menggunakan metode ini, Anda harus menentukan pencetak, pengandar, dan porta yang sahih. Jika tidak valid, API tidak gagal tetapi hasilnya tidak ditentukan. Ini bisa menyebabkan program lain menyetel kembali pencetak ke pencetak yang sahih sebelumnya. Anda dapat menggunakan EnumPrinters untuk mengambil nama printer, nama pengandar, dan nama port dari semua pencetak yang tersedia.
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 |
SetDefaultPrinterW (Unicode) dan SetDefaultPrinterA (ANSI) |