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