Метод IPrintSchemaCapabilities::GetFeatureByKeyName (printerextension.h)

Статья
02/26/2024

Возвращает функцию из PrintCapabilities на основе заданного имени ключа.

Синтаксис

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

Параметры

[in] bstrKeyName

Имя ключа компонента.

[out, retval] ppFeature

Возвращаемая функция.

Возвращаемое значение

Этот метод возвращает значение HRESULT .

Распознаются только следующие имена ключей функций. Имена ключей эквивалентны именам функций общедоступной схемы печати, как показано в следующей таблице. В таблице также показаны функции, имеющие специализированные типы параметров (по умолчанию типом параметра является IPrintSchemaOption).

Имя	Открытое имя функции схемы печати	Специализированный тип параметра
DocumentBinding	DocumentBinding или JobBindAllDocuments
DocumentCollate	DocumentCollate
DocumentDuplex	JobDuplexAllDocumentsContiguously
DocumentHolePunch	DocumentHolePunch или JobHolePunch
DocumentInputBin	JobInputBin, DocumentInputBin или PageInputBin
DocumentNUp	JobNUpAllDocumentsContiguously	IPrintSchemaNUpOption
DocumentStaple	JobStapleAllDocuments или DocumentStaple
PageMediaSize	PageMediaSize	IPrintSchemaPageMediaSizeOption
PageMediaType	PageMediaType
PageOrientation	PageOrientation
PageOutputColor	PageOutputColor
PageOutputQuality	PageOutputQuality

Если запрошенный компонент, параметр или свойство не найден, этот метод возвращает S_FALSE и задает указатель NULL на выходной объект компонента, параметра или свойства.

Поэтому если объект IPrintSchemaTicket не содержит указанных признаков, параметров или свойств, приложение должно получить объект IPrintSchemaCapabilities и запросить его с помощью IPrintSchemaCapabilities::GetFeatureByKeyName или IPrintSchemaCapabilities::GetFeature.

Требования

Требование	Значение
Минимальная версия клиента	Windows 8
Целевая платформа	Персональный компьютер
Верхняя часть	printerextension.h

См. также раздел

IPrintSchemaCapabilities

IPrintSchemaNUpOption

IPrintSchemaOption

IPrintSchemaPageMediaSizeOption

Поделиться через