IPrintOemPrintTicketProvider::QueryDeviceDefaultNamespace メソッド (prcomoem.h)
IPrintOemPrintTicketProvider::QueryDeviceDefaultNamespace メソッドは、既定の名前空間の均一リソース識別子 (URI) についてデバイスに対してクエリを実行します。
構文
HRESULT QueryDeviceDefaultNamespace(
[out] OUT BSTR *pbstrNamespaceUri
);
パラメーター
[out] pbstrNamespaceUri
名前空間 URI を受け取る BSTR へのポインター。 プラグインは、 pbstrNamespaceUri が指すバッファーに名前空間 URI を配置します。 IPrintOemPrintTicketProvider::QueryDeviceDefaultNamespace は、SysAllocString の呼び出し (Microsoft Windows SDKドキュメントで説明) を使用して文字列を割り当てる役割を担いますが、呼び出し元は文字列を解放する責任があります。
戻り値
IPrintOemPrintTicketProvider::QueryDeviceDefaultNamespace は、次のいずれかの値を返す必要があります。
| リターン コード | 説明 |
|---|---|
| S_OK | 操作が成功しました。 |
| E_NOTIMPL | プラグインは、プラグインのプロバイダーからコア ドライバーによって生成された既定の名前空間をオーバーライドする予定はありません。 |
注釈
プラグインでは、コア ドライバーが認識しない GPD ファイルまたは PPD ファイルで定義されている機能を処理するためにコア ドライバーが使用するプライベート名前空間 URI の名前を指定する必要があります。 プラグインでは、 IPrintOemPrintTicketProvider::BindPrinter メソッドの呼び出しの結果として名前空間のセットを指定できます。 IPrintOemPrintTicketProvider::QueryDeviceDefaultNamespace の目的は、これらの名前空間のうち、既定の名前空間として使用する名前空間をコア ドライバーに通知することです。 コア ドライバーは、認識されないすべての機能をこの既定の名前空間に関連付け、そのような機能を印刷チケットに配置します。
IPrintOemPrintTicketProvider::QueryDeviceDefaultNamespace が返されると、コア ドライバーは、プラグインが指定したプライベート名前空間 URI (*pbstrNamespaceUri 内) を DOM ドキュメントのルート ノードに追加する役割を担います。 また、コア ドライバーは、プラグインがプラグインのプライベート名前空間の下にある印刷チケットに新しいノードを追加するときに、プラグインが使用するプライベート名前空間のプレフィックスを定義する必要もあります。 プラグインでは、この既定のプライベート名前空間 URI に独自のプレフィックスを定義しないでください。
要件
| 要件 | 値 |
|---|---|
| 対象プラットフォーム | デスクトップ |
| Header | prcomoem.h (Prcomoem.h を含む) |