IPrintOemUI2::QueryJobAttributes-Methode (prcomoem.h)

Artikel
02/07/2025

Die IPrintOemUI2::QueryJobAttributes-Methode ermöglicht es einem UI-Plug-In, die Ergebnisse des Kerntreibers nach einem Aufruf des DrvQueryJobAttributes DDI zu verarbeiten. Das Plug-In kann die Werte überschreiben, die der Kerntreiber im lpAttributeInfo Ausgabepuffer platziert hat.

Syntax

HRESULT QueryJobAttributes(
  HANDLE   hPrinter,
  PDEVMODE pDevmode,
  DWORD    dwLevel,
  LPBYTE   lpAttributeInfo
);

Parameter

hPrinter

Gibt den vom Anrufer bereitgestellten Druckerhandle an.

pDevmode

Zeiger auf eine vom Aufrufer bereitgestellte DEVMODEW--Struktur.

dwLevel

Gibt einen vom Aufrufer bereitgestellten Wert an, der den Typ der Struktur angibt, auf die durch lpAttributeInfoverwiesen wird, wie in der folgenden Tabelle angegeben.

Wert	Struktur verweist auf lpAttributeInfo
1	ATTRIBUTE_INFO_1
2	ATTRIBUTE_INFO_2
3	ATTRIBUTE_INFO_3
4	ATTRIBUTE_INFO_4

Beachten Sie: Wenn diese Methode dwDrvXxx Member der ATTRIBUTE_INFO_N- Strukturen ändert, geht der Spooler davon aus, dass das Plug-In das durch dieses Element dargestellte Verhalten unterstützen kann.

lpAttributeInfo

Zeigen Sie auf einen Speicherspeicherort, der die Adresse einer Struktur des Typs empfängt, der durch dwLevelidentifiziert wird.

Rückgabewert

Wenn das UI-Plug-In diese Methode unterstützt und die Methode erfolgreich war, sollte sie S_OK zurückgeben. Dies bewirkt, dass der Kerntreiber TRUE- für die DrvQueryJobAttributes DDI zurückgibt. Wenn das UI-Plug-In diese Methode unterstützt, die Methode jedoch fehlgeschlagen ist, sollte sie E_FAIL zurückgeben. Dies bewirkt, dass der Kerntreiber FALSE- für das DrvQueryJobAttributes DDI zurückgibt. Wenn das UI-Plug-In diese Methode nicht unterstützt, sollte sie E_NOTIMPL zurückgeben.

Bemerkungen

Wenn der Drucker mehrere UI-Plug-Ins installiert hat, ruft der Kerntreiber die UI-Plug-Ins in der Reihenfolge auf, in der sie installiert wurden. Das von dem letzten UI-Plug-In zurückgegebene HRESULT, das diese Methode unterstützt, wird verwendet, um den DrvQueryJobAttributes DDI-Rückgabewert des Kerntreibers zu bestimmen, wie im vorherigen Abschnitt beschrieben.

Weitere Informationen finden Sie unter DrvQueryJobAttributes.