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 对其进行查询。