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

  • Artikel

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
S_OK
 Der Vorgang wurde erfolgreich ausgeführt.
E_FAIL
 Fehler beim Vorgang.
E_NOTIMPL
 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)

Weitere Informationen

DevQueryPrintEx