IPrintSchemaCapabilities::GetFeatureByKeyName メソッド (printerextension.h)

[アーティクル]
03/05/2024

指定したキー名に基づいて 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 を使用してクエリを実行する必要があります。