Метод IPrintSchemaCapabilities::GetFeatureByKeyName (printerextension.h)
Возвращает функцию из 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 |