Metodo IPrintOemUI2::QueryJobAttributes (prcomoem.h)

Articolo
02/29/2024

Il IPrintOemUI2::QueryJobAttributes metodo consente a un plug-in dell'interfaccia utente di post-elaborare i risultati del driver core dopo una chiamata all'DDI DrvQueryJobAttributes . Il plug-in può scegliere di sovrascrivere i valori inseriti dal driver principale nel buffer di output lpAttributeInfo .

Sintassi

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

Parametri

hPrinter

Specifica l'handle della stampante fornito dal chiamante.

pDevmode

Puntatore a una struttura DEVMODEW fornita dal chiamante.

dwLevel

Specifica un valore fornito dal chiamante che indica il tipo di struttura a cui punta lpAttributeInfo, come indicato nella tabella seguente.

Valore	Struttura a cui punta lpAttributeInfo
1	ATTRIBUTE_INFO_1
2	ATTRIBUTE_INFO_2
3	ATTRIBUTE_INFO_3
4	ATTRIBUTE_INFO_4

Si noti che se questo metodo modifica qualsiasi membro dwDrvXxx delle strutture ATTRIBUTE_INFO_N , lo spooler presuppone che il plug-in sia in grado di supportare il comportamento rappresentato da tale membro.

lpAttributeInfo

Puntatore a una posizione di memoria che riceve l'indirizzo di una struttura del tipo identificato da dwLevel.

Valore restituito

Se il plug-in dell'interfaccia utente supporta questo metodo e il metodo ha avuto esito positivo, deve restituire S_OK. In questo modo il driver core restituisce TRUE per l'DDI DrvQueryJobAttributes . Se il plug-in dell'interfaccia utente supporta questo metodo, ma il metodo non è riuscito, deve restituire E_FAIL. In questo modo il driver principale restituisce FALSE per l'DDI DrvQueryJobAttributes. Se il plug-in dell'interfaccia utente non supporta questo metodo, deve restituire E_NOTIMPL.

Commenti

Quando la stampante dispone di più plug-in dell'interfaccia utente installati, il driver principale chiama i plug-in dell'interfaccia utente nell'ordine in cui sono stati installati. Il valore HRESULT restituito dall'ultimo plug-in dell'interfaccia utente che supporta questo metodo viene usato per determinare il valore restituito DDI drvQueryJobAttributes del driver principale, come descritto nella sezione precedente.

Per altre informazioni, vedere DrvQueryJobAttributes .