Метод 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 должен возвращать одно из следующих значений.

Комментарии

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

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

Требования

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

IPrintOemPrintTicketProvider

IPrintOemPrintTicketProvider::BindPrinter