Método IPrintOemPrintTicketProvider::QueryDeviceDefaultNamespace (prcomoem.h)
El método IPrintOemPrintTicketProvider::QueryDeviceDefaultNamespace consulta el dispositivo por 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 (que se describe en la documentación del SDK de Microsoft Windows), 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 generado por el controlador principal del proveedor del complemento. |
Observaciones
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 podría especificar un conjunto de espacios de nombres como resultado de la llamada al método IPrintOemPrintTicketProvider::BindPrintPrinter. El propósito del IPrintOemPrintTicketProvider::QueryDeviceDefaultNamespace es informar al controlador principal sobre cuál de estos espacios de nombres se 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 IPrintOemPrintTicketProvider::QueryDeviceDefaultNamespace devuelve, el controlador principal es responsable de agregar el URI de 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 | Valor |
|---|---|
| de la plataforma de destino de | Escritorio |
| encabezado de | prcomoem.h (include Prcomoem.h) |