Metode IPrintSchemaCapabilities::GetFeatureByKeyName (printerextension.h)

Artikel
02/27/2024

Mendapatkan fitur dari PrintCapabilities berdasarkan nama kunci tertentu.

Sintaks

HRESULT GetFeatureByKeyName(
  [in]          BSTR                bstrKeyName,
  [out, retval] IPrintSchemaFeature **ppFeature
);

Parameter

[in] bstrKeyName

Nama kunci fitur.

[out, retval] ppFeature

Fitur yang dikembalikan.

Nilai kembali

Metode ini mengembalikan nilai HRESULT .

Keterangan

Hanya nama kunci fitur berikut yang dikenali. Nama kunci setara dengan nama fitur Skema Cetak publik seperti yang diperlihatkan dalam tabel berikut. Tabel juga memperlihatkan fitur yang memiliki jenis opsi khusus (secara default jenis opsinya adalah IPrintSchemaOption).

Nama	Mencetak nama publik fitur skema	Jenis opsi khusus
DocumentBinding	DocumentBinding atau JobBindAllDocuments
DocumentCollate	DocumentCollate
DocumentDuplex	JobDuplexAllDocumentsKontiguously
DocumentHolePunch	DocumentHolePunch atau JobHolePunch
DocumentInputBin	JobInputBin, DocumentInputBin, atau PageInputBin
DocumentNUp	JobNUpAllDocuments Secara Berdampingan	IPrintSchemanUpOption
DocumentStaple	JobStapleAllDocuments atau DocumentStaple
PageMediaSize	PageMediaSize	IPrintSchemaPageMediaSizeOption
PageMediaType	PageMediaType
PageOrientation	PageOrientation
PageOutputColor	PageOutputColor
PageOutputQuality	PageOutputQuality

Ketika fitur, opsi, atau properti yang diminta tidak ditemukan, metode ini mengembalikan S_FALSE dan mengatur penunjuk NULL pada objek output fitur, opsi, atau properti.

Jadi, jika objek IPrintSchemaTicket tidak berisi fitur, opsi, atau properti yang ditentukan, aplikasi harus mendapatkan objek IPrintSchemaCapabilities dan mengkuerinya melalui IPrintSchemaCapabilities::GetFeatureByKeyName atau melalui IPrintSchemaCapabilities::GetFeature.