IPrintOemUI::D evQueryPrintEx-Methode (prcomoem.h)

Mit der IPrintOemUI::DevQueryPrintEx-Methode kann ein Benutzeroberflächen-Plug-In ermitteln, ob ein Druckauftrag druckbar ist.

Syntax

HRESULT DevQueryPrintEx(
  POEMUIOBJ           poemuiobj,
  PDEVQUERYPRINT_INFO pDQPInfo,
  PDEVMODE            pPublicDM,
  PVOID               pOEMDM
);

Parameter

poemuiobj

Vom Aufrufer bereitgestellter Zeiger auf eine OEMUIOBJ--Struktur.

pDQPInfo

Vom Aufrufer bereitgestellter Zeiger auf eine DEVQUERYPRINT_INFO-Struktur.

pPublicDM

Vom Aufrufer bereitgestellter Zeiger auf eine validierte DEVMODEW--Struktur.

pOEMDM

Vom Aufrufer bereitgestellter Zeiger auf die privaten DEVMODEW-Strukturmber des Benutzeroberflächen-Plug-Ins.

Rückgabewert

Die Methode muss einen der folgenden Werte zurückgeben.

Rückgabecode	Beschreibung
S_OK	Der Vorgang war erfolgreich.
E_FAIL	Fehler beim Vorgang.
E_NOTIMPL	Die Methode ist nicht implementiert.

Bemerkungen

Die IPrintOemUI::DevQueryPrintEx-Methode eines Plug-Ins für die Benutzeroberfläche führt dieselben Arten von Vorgängen wie die DevQueryPrintEx--Funktion aus, die von DLLs der Benutzeroberfläche exportiert wird. Sie können diese Methode verwenden, um die von der DevQueryPrintEx--Funktion bereitgestellte Funktionalität zu verbessern. Wie die DevQueryPrintEx--Funktion liegt die Verantwortung der IPrintOemUI::DevQueryPrintEx Methode darin, zu bestimmen, ob der von der bereitgestellten DEVMODEW-Struktur beschriebene Druckauftrag gedruckt werden kann.

Wenn die DevQueryPrintEx--Funktion des Treibers aufgerufen wird, überprüft sie die DEVMODEW-Struktur zusammen mit den aktuell ausgewählten Druckeroptionen, um festzustellen, ob der Auftrag druckbar ist. Andernfalls gibt die Funktion FALSEzurück. Wenn der Auftrag druckbar erscheint, ruft die Funktion die IPrintOemUI::DevQueryPrintEx-Methode in jedem Benutzeroberflächen-Plug-In auf, das dem Treiber zugeordnet ist. Wenn alle IPrintOemUI::DevQueryPrintEx Methoden S_OK zurückgeben, gibt DevQueryPrintExTRUEzurück. Daher ist ein Auftrag nicht druckbar, es sei denn, die DevQueryPrintEx--Funktion und alle IPrintOemUI::DevQueryPrintEx Methoden deklarieren sie als druckbar.

Wenn IPrintOemUI::DevQueryPrintEx Methoden von mehreren Benutzeroberflächen-Plug-Ins exportiert werden, werden die Methoden in der Reihenfolge aufgerufen, in der die Plug-Ins für die Installation angegeben werden.

Weitere Informationen zum Erstellen und Installieren von Plug-Ins für die Benutzeroberfläche finden Sie unter Anpassen der Druckertreiber von Microsoft.

Anforderungen

Anforderung	Wert
Zielplattform-	Desktop
Header-	prcomoem.h (einschließlich Prcomoem.h)

Siehe auch

DevQueryPrintEx-