Поделиться через

Метод IPrintOemPrintTicketProvider::QueryDeviceDefaultNamespace (prcomoem.h)

  • Статья

Метод IPrintOemPrintTicketProvider::QueryDeviceDefaultNamespace запрашивает у устройства универсальный код ресурса (URI) пространства имен по умолчанию.

Синтаксис

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

Параметры

[out] pbstrNamespaceUri

Указатель на BSTR, получающий универсальный код ресурса (URI) пространства имен. Подключаемый модуль помещает URI пространства имен в буфер, на который указывает pbstrNamespaceUri. IPrintOemPrintTicketProvider::QueryDeviceDefaultNamespace отвечает за выделение строки с помощью вызова SysAllocString (описанного в документации по Microsoft Windows SDK), но вызывающий объект отвечает за освобождение строки.

Возвращаемое значение

IPrintOemPrintTicketProvider::QueryDeviceDefaultNamespace должен возвращать одно из следующих значений.

Код возврата Описание
S_OK Операция успешно выполнена.
E_NOTIMPL Подключаемый модуль не планирует переопределять пространство имен по умолчанию, созданное основным драйвером из поставщика подключаемого модуля.

Комментарии

Подключаемый модуль должен указать имя URI частного пространства имен, который основной драйвер должен использовать для обработки любых функций, определенных в файле GPD или PPD-файле, которые основной драйвер не распознает. Подключаемый модуль может указать набор пространств имен в результате вызова метода IPrintOemPrintTicketProvider::BindPrinter . Целью IPrintOemPrintTicketProvider::QueryDeviceDefaultNamespace является информирование основного драйвера о том, какое из этих пространств имен будет использоваться в качестве пространства имен по умолчанию. Основной драйвер связывает все функции, которые он не распознает, с этим пространством имен по умолчанию, и помещает такие функции в билет печати.

При возврате IPrintOemPrintTicketProvider::QueryDeviceDefaultNamespace основной драйвер отвечает за добавление URI частного пространства имен, указанного подключаемым модулем (в *pbstrNamespaceUri), в корневой узел документа DOM. Основной драйвер также должен определить префикс для частного пространства имен, которое подключаемый модуль должен использовать, когда подключаемый модуль добавляет новый узел в билет печати в частном пространстве имен подключаемого модуля. Подключаемый модуль не должен определять собственный префикс для этого URI частного пространства имен по умолчанию.

Требования

Требование Значение
Целевая платформа Персональный компьютер
Верхняя часть prcomoem.h (включая Prcomoem.h)

См. также раздел

IPrintOemPrintTicketProvider

IPrintOemPrintTicketProvider::BindPrinter