Fungsi SetForm

Fungsi SetForm mengatur informasi formulir untuk printer yang ditentukan.

Sintaks

BOOL SetForm(
  _In_ HANDLE hPrinter,
  _In_ LPTSTR pFormName,
  _In_ DWORD  Level,
  _In_ LPTSTR pForm
);

Parameter

hPrinter [in]

Handel ke pencetak yang informasi formulirnya disetel. Gunakan fungsi OpenPrinter atau AddPrinter untuk mengambil handel printer.

pFormName [in]

Penunjuk ke string yang dihentikan null yang menentukan nama formulir tempat informasi formulir diatur.

Level [in]

Versi struktur yang menunjuk pForm . Nilai ini harus 1 atau 2.

pForm [in]

Penunjuk ke struktur FORM_INFO_1 atau FORM_INFO_2 .

Menampilkan 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.

SetForm dapat dipanggil beberapa kali untuk FORM_INFO_2 yang ada, setiap panggilan menambahkan pasangan tambahan nilai pDisplayName dan wLangId . Semua versi bahasa formulir akan mendapatkan nilai Ukuran dan ImageableArea dari FORM_INFO_2 dalam panggilan terbaru ke SetForm.

Jika penelepon jarak jauh dan Tingkat adalah 2, nilai StringTypedari FORM_INFO_2 tidak dapat STRING_MUIDLL.

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	SetFormW (Unicode) dan SetFormA (ANSI)

Lihat juga

Pencetakan

Cetak Fungsi API Spooler

GetForm

OpenPrinter

FORM_INFO_1

FORM_INFO_2