Fungsi CommitSpoolData

Fungsi CommitSpoolData memberi tahu penampung cetak bahwa sejumlah data tertentu telah ditulis ke file penampung tertentu dan siap untuk dirender.

Sintaks

HANDLE CommitSpoolData(
  _In_ HANDLE hPrinter,
  _In_ HANDLE hSpoolFile,
       DWORD  cbCommit
);

Parameter

hPrinter [in]

Handel ke pencetak tempat pekerjaan dikirimkan. Ini harus menjadi handel yang sama yang digunakan untuk mendapatkan hSpoolFile dengan GetSpoolFileHandle.

hSpoolFile [in]

Handel ke file spool sedang diubah. Pada panggilan pertama CommitSpoolData, ini harus menjadi handel yang sama yang dikembalikan oleh GetSpoolFileHandle. Panggilan berikutnya ke CommitSpoolData harus melewati handel yang dikembalikan oleh panggilan sebelumnya. Lihat Keterangan.

cbCommit

Jumlah byte yang diterapkan pada penampung cetak.

Menampilkan nilai

Jika fungsi berhasil, fungsi akan mengembalikan handel ke file spool.

Jika fungsi gagal, fungsi akan mengembalikan INVALID_HANDLE_VALUE.

Keterangan

Aplikasi yang mengirimkan pekerjaan cetak penampung dapat memanggil GetSpoolFileHandle dan kemudian langsung menulis data ke handel file penampung dengan memanggil WriteFile. Untuk memberi tahu penampung cetak bahwa file berisi data yang siap dirender, aplikasi harus memanggil CommitSpoolData dan menyediakan jumlah byte yang tersedia.

Jika CommitSpoolData dipanggil beberapa kali, setiap panggilan harus menggunakan handel file penampung yang dikembalikan oleh panggilan sebelumnya. Ketika tidak ada lagi data yang akan ditulis ke file penampung, CloseSpoolFileHandle harus dipanggil untuk handel file yang dikembalikan oleh panggilan terakhir ke CommitSpoolData.

Sebelum memanggil CommitSpoolData, aplikasi harus mengatur penunjuk file ke posisi yang dimilikinya sebelum menulis data ke file. Dalam proses penyajian data dalam file penampung, penampung cetak akan memindahkan penunjuk file penampung spool cbCommit byte dari nilai penunjuk file saat ini.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 [hanya aplikasi desktop]
Header	Winspool.h (termasuk Windows.h)
Pustaka	Winspool.lib
DLL	WinSpool.drv

Lihat juga

Pencetakan

Cetak Fungsi API Spooler

GetSpoolFileHandle

CloseSpoolFileHandle