Fungsi PTOpenProviderEx (prntvpt.h)

Artikel
03/04/2024

Membuka instans penyedia tiket cetak.

Sintaks

HRESULT PTOpenProviderEx(
  [in]  PCWSTR      pszPrinterName,
        DWORD       dwMaxVersion,
        DWORD       dwPrefVersion,
  [out] HPTPROVIDER *phProvider,
  [out] DWORD       *pUsedVersion
);

Parameter

[in] pszPrinterName

Penunjuk ke nama lengkap antrean cetak.

dwMaxVersion

Versi terbaru Skema Cetak yang didukung pemanggil.

dwPrefVersion

Versi Skema Cetak yang diminta oleh pemanggil.

[out] phProvider

Penunjuk ke handel untuk penyedia.

[out] pUsedVersion

Penunjuk ke versi Skema Cetak yang akan digunakan penyedia tiket cetak.

Nilai kembali

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

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.

Parameter pszPrinterName harus berupa nama lengkap, bukan nama yang dipotong karena mungkin muncul di DEVMODE.

Versi pertama Skema Cetak dirilis dengan Windows Vista dan versi 1. Jika penyedia tiket cetak tidak mendukung prefVersion, PTOpenProviderEx berhasil membuka handel dan mengembalikan versi sebelumnya di usedVersion.

Untuk menghindari kebocoran sumber daya, phProvider harus ditutup dengan PTCloseProvider.

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