Метод IPrintSchemaTicket::GetFeature (printerextension.h)

Статья
02/26/2024

Возвращает именованный компонент из PrintTicket по имени и полному URI пространства имен.

Синтаксис

HRESULT GetFeature(
  [in]          BSTR                bstrName,
  [in]          BSTR                bstrNamespaceUri,
  [out, retval] IPrintSchemaFeature **ppFeature
);

Параметры

[in] bstrName

Базовое имя значения атрибута name элемента компонента. Например, для функции <схемы печати psf:Feature name="psk:JobOutputBin"> базовое имя компонента — JobOutputBin.

[in] bstrNamespaceUri

URI пространства имен значения атрибута name элемента компонента. Например, URI пространства имен общедоступной функции схемы печати "JobOutputBin" имеет значение "https://schemas.microsoft.com/windows/2003/08/printing/printschemakeywords". Если функция не определена в общедоступной схеме печати, это должен быть универсальный код ресурса (URI) частного пространства имен, определяющего функцию.

[out, retval] ppFeature

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

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

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

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

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

Требования

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