Метод 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 |