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 查詢它。