Método IPrintOemPrintTicketProvider::QueryDeviceDefaultNamespace (prcomoem.h)
O método IPrintOemPrintTicketProvider::QueryDeviceDefaultNamespace consulta o dispositivo por seu URI (identificador de recurso uniforme) de namespace padrão.
Sintaxe
HRESULT QueryDeviceDefaultNamespace(
[out] OUT BSTR *pbstrNamespaceUri
);
Parâmetros
[out] pbstrNamespaceUri
Um ponteiro para um BSTR que recebe o URI do namespace. O plug-in coloca o URI do namespace no buffer apontado por pbstrNamespaceUri. IPrintOemPrintTicketProvider::QueryDeviceDefaultNamespace é responsável por alocar a cadeia de caracteres por meio de uma chamada para SysAllocString (descrita na documentação do SDK do Microsoft Windows), mas o chamador é responsável por liberar a cadeia de caracteres.
Retornar valor
IPrintOemPrintTicketProvider::QueryDeviceDefaultNamespace deve retornar um dos seguintes valores.
| Código de retorno | Descrição |
|---|---|
| S_OK | A operação foi realizada com êxito. |
| E_NOTIMPL | O plug-in não pretende substituir o namespace padrão gerado pelo driver principal do provedor do plug-in. |
Comentários
O plug-in deve especificar o nome do URI de namespace privado que o driver principal deve usar para lidar com os recursos definidos no arquivo GPD ou arquivo PPD que o driver principal não reconhece. O plug-in pode especificar um conjunto de namespaces como resultado da chamada para o método IPrintOemPrintTicketProvider::BindPrinter . A finalidade do IPrintOemPrintTicketProvider::QueryDeviceDefaultNamespace é informar o driver principal sobre qual desses namespaces deve ser usado como o namespace padrão. O driver principal associa todos os recursos que não reconhece com esse namespace padrão e coloca esses recursos no tíquete de impressão.
Quando IPrintOemPrintTicketProvider::QueryDeviceDefaultNamespace retorna, o driver principal é responsável por adicionar o URI de namespace privado especificado pelo plug-in (em *pbstrNamespaceUri) ao nó raiz do documento DOM. O driver principal também deve definir um prefixo para o namespace privado que o plug-in deve usar quando o plug-in adiciona um novo nó ao tíquete de impressão no namespace privado do plug-in. O plug-in não deve definir seu próprio prefixo para esse URI de namespace privado padrão.
Requisitos
| Requisito | Valor |
|---|---|
| Plataforma de Destino | Área de Trabalho |
| Cabeçalho | prcomoem.h (inclua Prcomoem.h) |