Metodo IPrintOemPrintTicketProvider::QueryDeviceDefaultNamespace (prcomoem.h)

Il metodo IPrintOemPrintTicketProvider::QueryDeviceDefaultNamespace esegue una query sul dispositivo per l'URI (Uniform Resource Identifier) dello spazio dei nomi predefinito.

Sintassi

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

Parametri

[out] pbstrNamespaceUri

Puntatore a un BSTR che riceve l'URI dello spazio dei nomi. Il plug-in inserisce l'URI dello spazio dei nomi nel buffer a cui punta pbstrNamespaceUri. IPrintOemPrintTicketProvider::QueryDeviceDefaultNamespace è responsabile dell'allocazione della stringa tramite una chiamata a SysAllocString (descritta nella documentazione di Microsoft Windows SDK), ma il chiamante è responsabile della liberazione della stringa.

Valore restituito

IPrintOemPrintTicketProvider::QueryDeviceDefaultNamespace deve restituire uno dei valori seguenti.

Commenti

Il plug-in deve specificare il nome dell'URI dello spazio dei nomi privato che il driver principale deve usare per gestire tutte le funzionalità definite nel file GPD o nel file PPD che il driver principale non riconosce. Il plug-in potrebbe specificare un set di spazi dei nomi in seguito alla chiamata al metodo IPrintOemPrintTicketProvider::BindPrinter . Lo scopo di IPrintOemPrintTicketProvider::QueryDeviceDefaultNamespace è informare il driver principale su quale di questi spazi dei nomi deve essere usato come spazio dei nomi predefinito. Il driver principale associa tutte le funzionalità che non riconosce a questo spazio dei nomi predefinito e inserisce tali funzionalità nel ticket di stampa.

Quando restituisce IPrintOemPrintTicketProvider::QueryDeviceDefaultNamespace , il driver principale è responsabile dell'aggiunta dell'URI dello spazio dei nomi privato specificato dal plug-in (in *pbstrNamespaceUri) al nodo radice del documento DOM. Il driver principale deve anche definire un prefisso per lo spazio dei nomi privato che il plug-in deve usare quando il plug-in aggiunge un nuovo nodo al ticket di stampa nello spazio dei nomi privato del plug-in. Il plug-in non deve definire il proprio prefisso per questo URI dello spazio dei nomi privato predefinito.

Requisiti

Vedi anche

IPrintOemPrintTicketProvider

IPrintOemPrintTicketProvider::BindPrinter