Метод IPrintOemPrintTicketProvider::QueryDeviceDefaultNamespace (prcomoem.h)
Метод IPrintOemPrintTicketProvider::QueryDeviceDefaultNamespace запрашивает устройство для его универсального идентификатора ресурса пространства имен по умолчанию (URI).
Синтаксис
HRESULT QueryDeviceDefaultNamespace(
[out] OUT BSTR *pbstrNamespaceUri
);
Параметры
[out] pbstrNamespaceUri
Указатель на BSTR, получающий универсальный код ресурса (URI) пространства имен. Подключаемый модуль помещает URI пространства имен в буфер, на который указывает pbstrNamespaceUri. IPrintOemPrintTicketProvider::QueryDeviceDefaultNamespace отвечает за выделение строки с помощью вызова SysAllocString (описано в документации по пакету SDK Для Microsoft Windows), но вызывающий объект отвечает за освобождение строки.
Возвращаемое значение
IPrintOemPrintTicketProvider::QueryDeviceDefaultNamespace должен возвращать одно из следующих значений.
| Возвращаемый код | Описание |
|---|---|
| S_OK | Операция завершилась успешно. |
| E_NOTIMPL | Подключаемый модуль не планирует переопределить пространство имен по умолчанию, созданное основным драйвером поставщика подключаемого модуля. |
Замечания
Подключаемый модуль должен указать имя URI частного пространства имен, который основной драйвер должен использовать для обработки любых функций, определенных в файле GPD или PPD-файле, который основной драйвер не распознает. Подключаемый модуль может указать набор пространств имен в результате вызова метода IPrintOemPrintTicketProvider::BindPrinter. Целью IPrintOemPrintTicketProvider::QueryDeviceDefaultNamespace является информирование основного драйвера о том, какие из этих пространств имен следует использовать в качестве пространства имен по умолчанию. Основной драйвер связывает все функции, которые он не распознает с этим пространством имен по умолчанию, и помещает все такие функции в билет на печать.
Когда возвращается IPrintOemPrintTicketProvider::QueryDeviceDefaultNamespace, основной драйвер отвечает за добавление URI частного пространства имен, указанного подключаемым модулем (в *pbstrNamespaceUri) в корневой узел документа DOM. Основной драйвер также должен определить префикс для частного пространства имен, которое подключаемый модуль должен использовать, когда подключаемый модуль добавляет новый узел в билет печати в частное пространство имен подключаемого модуля. Подключаемый модуль не должен определять собственный префикс для этого URI частного пространства имен по умолчанию.
Требования
| Требование | Ценность |
|---|---|
| целевая платформа | Настольный |
| заголовка | prcomoem.h (include Prcomoem.h) |