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)

Confira também

IPrintOemPrintTicketProvider

IPrintOemPrintTicketProvider::BindPrinter