Fungsi GetSpoolFileHandle

Fungsi GetSpoolFileHandle mengambil handel untuk file penampung yang terkait dengan pekerjaan yang saat ini dikirimkan oleh aplikasi.

Sintaks

HANDLE GetSpoolFileHandle(
  _In_ HANDLE hPrinter
);

Parameter

hPrinter [in]

Handel ke pencetak tempat pekerjaan dikirimkan. Ini harus menjadi handel yang sama yang digunakan untuk mengirimkan pekerjaan. (Gunakan fungsi OpenPrinter atau AddPrinter untuk mengambil handel printer.)

Mengembalikan nilai

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

Jika fungsi gagal, fungsi akan mengembalikan INVALID_HANDLE_VALUE.

Keterangan

Dengan handel ke file penampung, aplikasi Anda dapat menulis ke file penampung dengan panggilan ke WriteFile diikuti oleh CommitSpoolData.

Aplikasi Anda tidak boleh memanggil ClosePrinter di hPrinter hingga setelah mengakses file penampung untuk terakhir kalinya. Kemudian harus memanggil CloseSpoolFileHandle diikuti oleh ClosePrinter. Upaya untuk mengakses handel file penampung setelah hPrinter asli ditutup akan gagal meskipun handel file itu sendiri belum ditutup. CloseSpoolFileHandle sendiri akan gagal jika ClosePrinter dipanggil terlebih dahulu.

Fungsi ini akan gagal jika dipanggil sebelum tugas cetak selesai menampung.

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
Nama Unicode dan ANSI	GetSpoolFileHandleW (Unicode) dan GetSpoolFileHandleA (ANSI)

Lihat juga

Pencetakan

Cetak Fungsi API Spooler

OpenPrinter

AddPrinter

ClosePrinter

CloseSpoolFileHandle

CommitSpoolData