IPrintOemPrintTicketProvider::QueryDeviceDefaultNamespace 方法 (prcomoem.h)
IPrintOemPrintTicketProvider::QueryDeviceDefaultNamespace 方法将设备查询其默认命名空间统一资源标识符 (URI) 。
语法
HRESULT QueryDeviceDefaultNamespace(
[out] OUT BSTR *pbstrNamespaceUri
);
参数
[out] pbstrNamespaceUri
指向接收命名空间 URI 的 BSTR 的指针。 插件将命名空间 URI 放置在 pbstrNamespaceUri 指向的缓冲区中。 IPrintOemPrintTicketProvider::QueryDeviceDefaultNamespace 负责通过调用 Microsoft Windows SDK 文档) 中所述的 SysAllocString (分配字符串,但调用方负责释放字符串。
返回值
IPrintOemPrintTicketProvider::QueryDeviceDefaultNamespace 应返回以下值之一。
返回代码 | 说明 |
---|---|
S_OK | 操作成功。 |
E_NOTIMPL | 插件不打算替代核心驱动程序从插件的提供程序生成的默认命名空间。 |
注解
插件应指定专用命名空间 URI 的名称,核心驱动程序应使用该 URI 来处理核心驱动程序无法识别的 GPD 文件或 PPD 文件中定义的任何功能。 由于调用 IPrintOemPrintTicketProvider::BindPrinter 方法,插件可能会指定一组命名空间。 IPrintOemPrintTicketProvider::QueryDeviceDefaultNamespace 的目的是通知核心驱动程序哪些命名空间将用作默认命名空间。 核心驱动程序将它无法识别的所有功能与此默认命名空间相关联,并将任何此类功能置于打印票证中。
当 IPrintOemPrintTicketProvider::QueryDeviceDefaultNamespace 返回时,核心驱动程序负责将插件在 *pbstrNamespaceUri) 中指定的专用命名空间 URI 添加到 DOM 文档的根节点 (。 核心驱动程序还必须为在插件的专用命名空间下向打印票证添加新节点时插件应使用的专用命名空间定义前缀。 插件不应为此默认专用命名空间 URI 定义自己的前缀。
要求
要求 | 值 |
---|---|
目标平台 | 桌面 |
标头 | prcomoem.h (包括 Prcomoem.h) |