IPrintOemPrintTicketProvider::QueryDeviceDefaultNamespace 方法 (prcomoem.h)

IPrintOemPrintTicketProvider::QueryDeviceDefaultNamespace 方法查询设备的默认命名空间统一资源标识符(URI)。

语法

HRESULT QueryDeviceDefaultNamespace(
  [out] OUT BSTR *pbstrNamespaceUri
);

参数

[out] pbstrNamespaceUri

指向接收命名空间 URI 的 BSTR 的指针。 插件将命名空间 URI 放置在 pbstrNamespaceUri指向的缓冲区中。 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 (include Prcomoem.h)

另请参阅

IPrintOemPrintTicketProvider

IPrintOemPrintTicketProvider::BindPrinter