Método IPrintOemUI2::QueryJobAttributes (prcomoem.h)

Artigo
02/07/2025

O método IPrintOemUI2::QueryJobAttributes permite que um plug-in da interface do usuário postprocesse os resultados do driver principal após uma chamada para o DrvQueryJobAttributes DDI. O plug-in pode optar por substituir os valores que o driver principal colocou no lpAttributeInfo buffer de saída.

Sintaxe

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

Parâmetros

hPrinter

Especifica o identificador de impressora fornecido pelo chamador.

pDevmode

Ponteiro para uma estrutura de DEVMODEW fornecida pelo chamador.

dwLevel

Especifica um valor fornecido pelo chamador que indica o tipo de estrutura apontado por lpAttributeInfo, conforme indicado na tabela a seguir.

Valor	Estrutura apontada por lpAttributeInfo
1	ATTRIBUTE_INFO_1
2	ATTRIBUTE_INFO_2
3	ATTRIBUTE_INFO_3
4	ATTRIBUTE_INFO_4

Observe que, se esse método alterar qualquer dwDrvxxx membro das estruturas ATTRIBUTE_INFO_N, o spooler assumirá que o plug-in é capaz de dar suporte ao comportamento representado por esse membro.

lpAttributeInfo

Ponteiro para um local de memória que recebe o endereço de uma estrutura do tipo identificado por dwLevel.

Valor de retorno

Se o plug-in da interface do usuário der suporte a esse método e o método tiver êxito, ele deverá retornar S_OK. Isso faz com que o driver principal retorne TRUE para o DDI DrvQueryJobAttributes. Se o plug-in da interface do usuário der suporte a esse método, mas o método falhar, ele deverá retornar E_FAIL. Isso faz com que o driver principal retorne FALSE para a DDI drvQueryJobAttributes. Se o plug-in da interface do usuário não der suporte a esse método, ele deverá retornar E_NOTIMPL.

Observações

Quando a impressora tem vários plug-ins de interface do usuário instalados, o driver principal chama os plug-ins da interface do usuário na ordem em que foram instalados. O HRESULT retornado pelo último plug-in de interface do usuário que dá suporte a esse método é usado para determinar o valor de retorno drvQueryJobAttributes DDI do driver principal, conforme descrito na seção anterior.

Consulte DrvQueryJobAttributes para obter mais informações.