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
目标平台 桌面
Header printerextension.h

另请参阅

IPrintSchemaCapabilities

IPrintSchemaNUpOption

IPrintSchemaOption

IPrintSchemaPageMediaSizeOption