Fungsi PTConvertDevModeToPrintTicket (prntvpt.h)

Artikel
03/15/2023

Mengonversi struktur DEVMODE menjadi tiket cetak di dalam IStream.

Sintaks

HRESULT PTConvertDevModeToPrintTicket(
  [in] HPTPROVIDER       hProvider,
       ULONG             cbDevmode,
  [in] PDEVMODE          pDevmode,
  [in] EPrintTicketScope scope,
       IStream           *pPrintTicket
);

Parameter

[in] hProvider

Handel ke penyedia tiket cetak terbuka. Handel ini dikembalikan oleh PTOpenProvider atau fungsi PTOpenProviderEx .

cbDevmode

Ukuran DEVMODE dalam byte.

[in] pDevmode

Penunjuk ke DEVMODE.

[in] scope

Nilai yang menentukan cakupan pPrintTicket. Nilai ini dapat menentukan satu halaman, seluruh dokumen, atau semua dokumen dalam tugas cetak. Pengaturan dalam pDevmode yang berada di luar cakupan yang ditentukan tidak akan disertakan dalam pPrintTicket. Lihat Keterangan.

pPrintTicket

Penunjuk ke IStream dengan posisi pencariannya di awal tiket cetak.

Menampilkan nilai

Jika operasi berhasil, nilai yang dikembalikan S_OK, jika tidak , HRESULT berisi kode kesalahan.

Jika hProvider dibuka di utas yang berbeda, HRESULT E_INVALIDARG.

Untuk informasi selengkapnya tentang kode kesalahan COM, lihat Penanganan Kesalahan.

Keterangan

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 implementasi driver printer—faktor yang sulit diprediksi saat menulis aplikasi. Memanggil fungsi ini dari utas yang mengelola interaksi dengan antarmuka pengguna dapat membuat aplikasi tampak tidak responsif.

hProvider harus merupakan handel yang dibuka di utas yang sama dengan utas tempat digunakan untuk fungsi ini.

Jika pDevmode menunjuk ke printer yang berbeda, pengaturannya mungkin hilang dan diganti dengan default.

Pengaturan dalam pDevmode yang berada di luar cakupan tidak disertakan dalam pPrintTicket. Misalnya, jika cakupan adalah satu halaman, maka pengaturan di seluruh pekerjaan dan pengaturan di seluruh dokumen tidak disertakan. Cakupan pekerjaan mencakup cakupan dokumen dan cakupan halaman. Cakupan dokumen menyertakan cakupan halaman.

PTConvertDevModeToPrintTicket menulis tiket cetak ke IStream yang dirujuk oleh pPrintTicket mulai dari titik pencarian aliran saat ini. Setelah PTConvertDevModeToPrintTicket kembali, pemanggil harus mengatur ulang titik pencarian ke titik pencarian awal untuk membaca tiket cetak yang dikembalikan oleh fungsi.

Persyaratan


Klien minimum yang didukung	Windows XP [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Target Platform	Windows
Header	prntvpt.h
Pustaka	Prntvpt.lib
DLL	Prntvpt.dll

Lihat juga

Cetak Skema

Cetak Fungsi API Spooler

Pencetakan

Bagikan melalui