IPrintOemUI2::QueryJobAttributes-Methode (prcomoem.h)

Artikel
03/05/2024

Die IPrintOemUI2::QueryJobAttributes -Methode ermöglicht es einem UI-Plug-In, die Ergebnisse des Kerntreibers nach einem Aufruf des DrvQueryJobAttributes-DDI nachzuverarbeiten. 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 von lpAttributeInfo verwiesen wird, wie in der folgenden Tabelle angegeben.

Wert	Struktur, auf die von lpAttributeInfo verwiesen wird
1	ATTRIBUTE_INFO_1
2	ATTRIBUTE_INFO_2
3	ATTRIBUTE_INFO_3
4	ATTRIBUTE_INFO_4

Wenn diese Methode ein dwDrvXxx-Element der ATTRIBUTE_INFO_N-Strukturen ändert, geht der Spooler davon aus, dass das Plug-In das von diesem Member dargestellte Verhalten unterstützen kann.

lpAttributeInfo

Zeiger auf einen Speicherspeicherort, der die Adresse einer Struktur des von dwLevel identifizierten Typs empfängt.

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 den DrvQueryJobAttributes-DDI zurückgibt. Wenn das UI-Plug-In diese Methode unterstützt, die Methode jedoch fehlgeschlagen ist, sollte es E_FAIL zurückgeben. Dadurch gibt der Kerntreiber FALSE für drvQueryJobAttributes DDI zurück. Wenn das UI-Plug-In diese Methode nicht unterstützt, sollte es E_NOTIMPL zurückgeben.

Hinweise

Wenn auf dem Drucker mehrere UI-Plug-Ins installiert sind, ruft der Kerntreiber die UI-Plug-Ins in der Reihenfolge auf, in der sie installiert wurden. Das vom 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 .