Método IPrintOemPrintTicketProvider::QueryDeviceDefaultNamespace (prcomoem.h)

El método IPrintOemPrintTicketProvider::QueryDeviceDefaultNamespace consulta el dispositivo para ver su identificador uniforme de recursos (URI) del espacio de nombres predeterminado.

Sintaxis

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

Parámetros

[out] pbstrNamespaceUri

Puntero a un BSTR que recibe el URI del espacio de nombres. El complemento coloca el URI del espacio de nombres en el búfer al que apunta pbstrNamespaceUri. IPrintOemPrintTicketProvider::QueryDeviceDefaultNamespace es responsable de asignar la cadena mediante una llamada a SysAllocString (descrita en la documentación de Microsoft Windows SDK), pero el autor de la llamada es responsable de liberar la cadena.

Valor devuelto

IPrintOemPrintTicketProvider::QueryDeviceDefaultNamespace debe devolver uno de los valores siguientes.

Código devuelto	Descripción
S_OK	La operación se realizó correctamente.
E_NOTIMPL	El complemento no pretende invalidar el espacio de nombres predeterminado que el controlador principal generó a partir del proveedor del complemento.

Comentarios

El complemento debe especificar el nombre del URI del espacio de nombres privado que el controlador principal debe usar para controlar las características definidas en el archivo GPD o en el archivo PPD que el controlador principal no reconoce. El complemento puede especificar un conjunto de espacios de nombres como resultado de la llamada al método IPrintOemPrintTicketProvider::BindPrintPrintEr . El propósito de IPrintOemPrintTicketProvider::QueryDeviceDefaultNamespace es informar al controlador principal sobre cuál de estos espacios de nombres se va a usar como espacio de nombres predeterminado. El controlador principal asocia todas las características que no reconoce con este espacio de nombres predeterminado y coloca estas características en el vale de impresión.

Cuando se devuelve IPrintOemPrintTicketProvider::QueryDeviceDefaultNamespace , el controlador principal es responsable de agregar el URI del espacio de nombres privado que el complemento ha especificado (en *pbstrNamespaceUri) al nodo raíz del documento DOM. El controlador principal también debe definir un prefijo para el espacio de nombres privado que el complemento debe usar cuando el complemento agrega un nuevo nodo al vale de impresión en el espacio de nombres privado del complemento. El complemento no debe definir su propio prefijo para este URI de espacio de nombres privado predeterminado.

Requisitos

Requisito	Value
Plataforma de destino	Escritorio
Encabezado	prcomoem.h (include Prcomoem.h)

Consulte también

IPrintOemPrintTicketProvider

IPrintOemPrintTicketProvider::BindPrinter