IPrintOemPrintTicketProvider::QueryDeviceDefaultNamespace メソッド (prcomoem.h)
IPrintOemPrintTicketProvider::QueryDeviceDefaultNamespace メソッドは、既定の名前空間の Uniform Resource Identifier (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 に独自のプレフィックスを定義しないでください。
必要条件
| 要件 | 価値 |
|---|---|
| ターゲット プラットフォーム の | デスクトップ |
| ヘッダー | prcomoem.h (Prcomoem.h を含む) |