Bewerken

Delen via


IPrintOemUI2::QueryJobAttributes method (prcomoem.h)

The IPrintOemUI2::QueryJobAttributes method allows a UI plug-in to postprocess the core driver's results after a call to the DrvQueryJobAttributes DDI. The plug-in can choose to overwrite the values that the core driver placed in the lpAttributeInfo output buffer.

Syntax

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

Parameters

hPrinter

Specifies the caller-supplied printer handle.

pDevmode

Pointer to a caller-supplied DEVMODEW structure.

dwLevel

Specifies a caller-supplied value indicating the type of structure pointed to by lpAttributeInfo, as indicated in the following table.

Value Structure Pointed to by lpAttributeInfo
1

ATTRIBUTE_INFO_1

2

ATTRIBUTE_INFO_2

3

ATTRIBUTE_INFO_3

4

ATTRIBUTE_INFO_4

 

Note that if this method changes any dwDrvXxx member of the ATTRIBUTE_INFO_N structures, the spooler assumes that the plug-in is able to support the behavior represented by that member.

lpAttributeInfo

Pointer to a memory location that receives the address of a structure of the type identified by dwLevel.

Return value

If the UI plug-in supports this method, and the method succeeded, it should return S_OK. This causes the core driver to return TRUE for the DrvQueryJobAttributes DDI. If the UI plug-in supports this method, but the method failed, it should return E_FAIL. This causes the core driver to return FALSE for the DrvQueryJobAttributes DDI. If the UI plug-in does not support this method, it should return E_NOTIMPL.

Remarks

When the printer has multiple UI plug-ins installed, the core driver calls the UI plug-ins in the order they were installed. The HRESULT returned by the last UI plug-in that supports this method is used to determine the core driver's DrvQueryJobAttributes DDI return value as described in the previous section.

See DrvQueryJobAttributes for more information.

Requirements

Requirement Value
Target Platform Desktop
Header prcomoem.h (include Prcomoem.h)

See also

ATTRIBUTE_INFO_1

ATTRIBUTE_INFO_2

ATTRIBUTE_INFO_3

ATTRIBUTE_INFO_4

DEVMODEW

DrvQueryJobAttributes

IPrintOemUI2