Baca dalam bahasa Inggris

Bagikan melalui


Fungsi AddForm

Fungsi AddForm menambahkan formulir ke daftar formulir yang tersedia yang dapat dipilih untuk printer yang ditentukan.

Sintaks

BOOL AddForm(
  _In_ HANDLE hPrinter,
  _In_ DWORD  Level,
  _In_ LPBYTE pForm
);

Parameter

hPrinter [in]

Handel ke pencetak yang mendukung pencetakan dengan formulir yang ditentukan. Gunakan fungsi OpenPrinter atau AddPrinter untuk mengambil handel printer.

Level [in]

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

pForm [in]

Penunjuk ke struktur FORM_INFO_1 atau FORM_INFO_2 .

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

Aplikasi dapat menentukan formulir mana yang tersedia untuk printer dengan memanggil fungsi EnumForms .

Jika pForm menunjuk ke FORM_INFO_2, maka AddForm akan gagal jika formulir dengan nama yang ditentukan sudah ada atau nilai pKeyword struktur sudah ada.

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
Spoolss.dll

Lihat juga

Pencetakan

Cetak Fungsi API Spooler

EnumForms

FORM_INFO_1

FORM_INFO_2

OpenPrinter