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
ターゲット プラットフォーム の	デスクトップ
ヘッダー	printerextension.h

関連項目

IPrintSchemaCapabilities

IPrintSchemaNUpOption

IPrintSchemaOption の

IPrintSchemaPageMediaSizeOption