IPrintOemPrintTicketProvider::QueryDeviceDefaultNamespace-Methode (prcomoem.h)
Die IPrintOemPrintTicketProvider::QueryDeviceDefaultNamespace-Methode fragt das Gerät nach seinem Standard-Namespace-URI (Uniform Resource Identifier) ab.
Syntax
HRESULT QueryDeviceDefaultNamespace(
[out] OUT BSTR *pbstrNamespaceUri
);
Parameter
[out] pbstrNamespaceUri
Ein Zeiger auf einen BSTR, der den Namespace-URI empfängt. Das Plug-In platziert den Namespace-URI im Puffer, auf den pbstrNamespaceUri verweist. IPrintOemPrintTicketProvider::QueryDeviceDefaultNamespace ist für die Zuweisung der Zeichenfolge durch einen Aufruf von SysAllocString verantwortlich (in der Microsoft Windows SDK-Dokumentation beschrieben), aber der Aufrufer ist für das Freigeben der Zeichenfolge verantwortlich.
Rückgabewert
IPrintOemPrintTicketProvider::QueryDeviceDefaultNamespace sollte einen der folgenden Werte zurückgeben.
| Rückgabecode | BESCHREIBUNG |
|---|---|
| S_OK | Der Vorgang wurde erfolgreich ausgeführt. |
| E_NOTIMPL | Das Plug-In beabsichtigt nicht, den Standardnamespace zu überschreiben, den der Kerntreiber vom Anbieter des Plug-Ins generiert hat. |
Hinweise
Das Plug-In sollte den Namen des privaten Namespace-URI angeben, den der Kerntreiber verwenden soll, um alle Features zu behandeln, die in der GPD- oder PPD-Datei definiert sind, die vom Kerntreiber nicht erkannt werden. Das Plug-In kann einen Satz von Namespaces als Ergebnis des Aufrufs der IPrintOemPrintTicketProvider::BindPrinter-Methode angeben. Der Zweck des IPrintOemPrintTicketProvider::QueryDeviceDefaultNamespace besteht darin, den Kerntreiber darüber zu informieren, welcher dieser Namespaces als Standardnamespace verwendet werden soll. Der Kerntreiber verknüpft alle Features, die er nicht erkennt, mit diesem Standardnamespace und platziert solche Features im Druckticket.
Wenn IPrintOemPrintTicketProvider::QueryDeviceDefaultNamespace zurückgibt, ist der Kerntreiber dafür verantwortlich, den vom Plug-In angegebenen privaten Namespace-URI (in *pbstrNamespaceUri) zum Stammknoten des DOM-Dokuments hinzuzufügen. Der Kerntreiber muss auch ein Präfix für den privaten Namespace definieren, den das Plug-In verwenden soll, wenn das Plug-In dem Druckticket unter dem privaten Namespace des Plug-Ins einen neuen Knoten hinzufügt. Das Plug-In sollte kein eigenes Präfix für diesen standardmäßigen privaten Namespace-URI definieren.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Desktop |
| Kopfzeile | prcomoem.h (einschließlich Prcomoem.h) |