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.
| Codice restituito | Descrizione |
|---|---|
| S_OK | Operazione riuscita. |
| E_NOTIMPL | Il plug-in non intende eseguire l'override dello spazio dei nomi predefinito generato dal driver principale dal provider del plug-in. |
Osservazioni
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 della IPrintOemPrintTicketProvider::QueryDeviceDefaultNamespace consiste nell'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 IPrintOemPrintTicketProvider::QueryDeviceDefaultNamespace restituisce, 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 predefinito dello spazio dei nomi privato.
Fabbisogno
| Requisito | Valore |
|---|---|
| piattaforma di destinazione | Desktop |
| intestazione | prcomoem.h (include Prcomoem.h) |