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	Winspool.h (termasuk Windows.h)
Pustaka	Winspool.lib
DLL	Winspool.drv
Nama Unicode dan ANSI	SetDefaultPrinterW (Unicode) dan SetDefaultPrinterA (ANSI)

Lihat juga

Pencetakan

Cetak Fungsi API Spooler

EnumPrinters

GetDefaultPrinter