Fungsi PTOpenProvider (prntvpt.h)

Artikel
03/13/2024

Membuka instans penyedia tiket cetak.

Sintaks

HRESULT PTOpenProvider(
  [in]  PCWSTR      pszPrinterName,
        DWORD       dwVersion,
  [out] HPTPROVIDER *phProvider
);

Parameter

[in] pszPrinterName

Penunjuk ke nama lengkap antrean cetak.

dwVersion

Versi Skema Cetak yang diminta oleh pemanggil.

[out] phProvider

Penunjuk ke handel untuk penyedia.

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.

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

Versi pertama Skema Cetak dirilis dengan Windows Vista dan versi 1. Operasi ini gagal jika versi tidak didukung. Berbeda dengan PTOpenProviderEx yang membuka penyedia meskipun hanya mendukung versi yang lebih awal dari yang diminta.

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