IPrintSchemaTicket::GetFeature メソッド (printerextension.h)

[アーティクル]
02/29/2024

名前と完全な名前空間 URI で PrintTicket から名前付き機能を取得します。

構文

HRESULT GetFeature(
  [in]          BSTR                bstrName,
  [in]          BSTR                bstrNamespaceUri,
  [out, retval] IPrintSchemaFeature **ppFeature
);

パラメーター

[in] bstrName

フィーチャー要素の name 属性値のベース名。たとえば、印刷スキーマ機能 <psf:Feature name="psk:JobOutputBin" の>場合、フィーチャーのベース名は "JobOutputBin" です。

[in] bstrNamespaceUri

機能要素の name 属性値の名前空間 URI。たとえば、パブリック印刷スキーマ機能 "JobOutputBin" の名前空間 URI は "https://schemas.microsoft.com/windows/2003/08/printing/printschemakeywords"" です。機能がパブリック印刷スキーマで定義されていない場合、これは機能を定義するプライベート名前空間の URI である必要があります。

[out, retval] ppFeature

返される機能。

戻り値

このメソッドは HRESULT 値を返します。

注釈

要求された機能、オプション、またはプロパティが見つからない場合、このメソッドはS_FALSEを返し、機能、オプション、またはプロパティの出力オブジェクトに NULL ポインターを設定します。

そのため、 IPrintSchemaTicket オブジェクトに指定された機能、オプション、またはプロパティが含まれていない場合、アプリは IPrintSchemaCapabilities オブジェクトを取得し、 IPrintSchemaCapabilities::GetFeatureByKeyName または IPrintSchemaCapabilities::GetFeature を使用してクエリを実行する必要があります。