Metode IPrintTicketProvider2::GetSupportedVersions (prdrvcom.h)

Metode IPrintTicketProvider2::GetSupportedVersions mengambil nomor versi utama skema cetak yang didukung oleh penyedia plug-in.

Sintaks

HRESULT GetSupportedVersions(
  [in]  IN HANDLE    hPrinter,
  [out] OUT INT * [] ppVersions,
  [out] OUT INT      *cVersions
);

Parameter

[in] hPrinter

Handel ke perangkat cetak.

[out] ppVersions

Penunjuk ke variabel yang menerima alamat elemen pertama dari array nomor versi. Nomor versi dalam array dapat muncul dalam urutan apa pun. Untuk informasi selengkapnya tentang parameter ini, lihat bagian Keterangan berikut.

[out] cVersions

Penunjuk ke variabel yang menerima jumlah elemen dalam array yang diarahkan oleh ppVersions.

Nilai kembali

IPrintTicketProvider2::GetSupportedVersions harus mengembalikan S_OK jika operasi berhasil. Jika metode ini gagal karena kurangnya memori atau sumber daya lainnya, metode ini harus mengembalikan kode kesalahan COM standar.

Keterangan

IPrintTicketProvider2::GetSupportedVersions mengembalikan nomor versi utama skema cetak yang didukung oleh antarmuka penyedia. Satu-satunya nomor versi yang ditentukan saat ini adalah 1. Penyedia dapat menghilangkan versi perantara.

Plug-in bertanggung jawab untuk mengalokasikan memori array yang diarahkan oleh parameter ppVersions . Plug-in harus mengalokasikan memori ini dengan menggunakan fungsi CoTaskMemAlloc yang dijelaskan dalam dokumentasi Microsoft Windows SDK, tetapi plug-in tidak bertanggung jawab untuk membebaskan memori ini.

Karena IPrintTicketProvider2::GetSupportedVersions dapat dipanggil sebelum metode IPrintTicketProvider2::BindPrinter dipanggil, penyedia plug-in OEM harus memeriksa dukungan versi berdasarkan handel yang diteruskan dalam parameter hPrinter . Akibatnya, penyedia plug-in OEM tidak boleh menutup handel printer yang terkait dengan hPrinter.

Persyaratan

Persyaratan	Nilai
Header	prdrvcom.h (termasuk Prdrvcom.h)

Lihat juga

IPrintTicketProvider2

IPrintTicketProvider2::BindPrinter