Fungsi PTGetPrintCapabilities (prntvpt.h)

Artikel
08/25/2023

Mengambil kapabilitas printer yang diformat sesuai dengan Skema Cetak XML.

Sintaks

HRESULT PTGetPrintCapabilities(
  [in]  HPTPROVIDER hProvider,
  [in]  IStream     *pPrintTicket,
        IStream     *pCapabilities,
  [out] BSTR        *pbstrErrorMessage
);

Parameter

[in] hProvider

Handel ke penyedia terbuka yang kemampuan cetaknya akan diambil. Handel ini dikembalikan oleh PTOpenProvider atau fungsi PTOpenProviderEx .

[in] pPrintTicket

Penunjuk ke aliran dengan posisi pencariannya di awal konten tiket cetak. Parameter ini bisa NULL.

pCapabilities

Penunjuk ke aliran tempat kemampuan cetak akan ditulis, dimulai pada posisi pencarian saat ini.

[out] pbstrErrorMessage

Penunjuk ke string yang menentukan apa, jika ada, tidak valid tentang pPrintTicket. Jika valid, nilai ini ADALAH NULL.

Nilai kembali

Jika operasi berhasil, nilai yang dikembalikan S_OK.

Jika hProvider dibuka di utas yang berbeda, HRESULT akan E_INVALIDARG.

Jika pPrintTicket tidak sesuai dengan Skema Cetak , HRESULT E_PRINTTICKET_FORMAT.

Jika pCapabilities tidak sesuai dengan Skema Cetak , HRESULT E_PRINTCAPABILITIES_FORMAT.

Jika hProvider dibuka di utas yang berbeda, HRESULT akan E_INVALIDARG.

Jika tidak, kode kesalahan lain dikembalikan di HRESULT. Untuk informasi selengkapnya tentang kode kesalahan COM, lihat Penanganan Kesalahan.

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 implementasi driver printer—faktor-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 berupa handel yang dibuka di utas yang sama dengan utas tempat digunakan untuk fungsi ini.

Pengandar pencetak menggunakan nilai pPrintTicket (ketika nilainya bukan NULL) untuk membuat pengaturan ketika pengandar menghasilkan kapabilitas printer yang bervariasi tergantung pada pengaturan saat ini.

Ketika fungsi kembali, posisi pencarian pPrintTicket berada di akhir konten tiket cetak dan posisi pencarian pCapabilities berada di akhir aliran. Jika pemanggil menggunakan aliran memori untuk pCapabilities, seperti aliran yang dibuat oleh CreateStreamOnHGlobal , pemanggil bertanggung jawab untuk mengatur ulang posisi pencarian sebelum membaca data.

Jika pbstrErrorMessage bukan NULL saat fungsi kembali, pemanggil harus membebaskan string dengan SysFreeString.

Persyaratan

Persyaratan	Nilai
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