IPrintOemUI::D evQueryPrintEx-Methode (prcomoem.h)
Mit IPrintOemUI::DevQueryPrintEx der Methode kann ein Benutzeroberfläche-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 überprüfte DEVMODEW-Struktur .
pOEMDM
Vom Aufrufer bereitgestellter Zeiger auf die privaten DEVMODEW-Strukturmitglieder des Benutzeroberflächen-Plug-Ins.
Rückgabewert
Die -Methode muss einen der folgenden Werte zurückgeben.
| Rückgabecode | BESCHREIBUNG |
|---|---|
|
Der Vorgang wurde erfolgreich ausgeführt. |
|
Fehler beim Vorgang. |
|
Die Methode ist nicht implementiert. |
Hinweise
Die Methode eines Benutzeroberflächen-Plug-Ins IPrintOemUI::DevQueryPrintEx führt dieselben Arten von Vorgängen wie die DevQueryPrintEx-Funktion aus, die von Benutzermodus-Druckerschnittstellen-DLLs exportiert wird. Sie können diese Methode verwenden, um die von der DevQueryPrintEx-Funktion bereitgestellte Funktionalität zu verbessern. Wie bei der DevQueryPrintEx-Funktion besteht die Aufgabe der IPrintOemUI::DevQueryPrintEx Methode darin, zu bestimmen, ob der druckauftrag gedruckt werden kann, der von der angegebenen DEVMODEW-Struktur beschrieben wird.
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 FALSE zurück. Wenn der Auftrag druckbar zu sein scheint, ruft die Funktion die IPrintOemUI::DevQueryPrintEx -Methode in jedem benutzeroberflächenbasierten Plug-In auf, das dem Treiber zugeordnet ist. Wenn alle IPrintOemUI::DevQueryPrintEx Methoden S_OK zurückgeben, gibt DevQueryPrintExTRUE zurück. Daher kann ein Auftrag nicht gedruckt werden, es sei denn, die DevQueryPrintEx-Funktion und alle IPrintOemUI::DevQueryPrintEx Methoden deklarieren ihn 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 Benutzeroberfläche-Plug-Ins finden Sie unter Anpassen der Druckertreiber von Microsoft.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Desktop |
| Kopfzeile | prcomoem.h (einschließlich Prcomoem.h) |