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

Artigo
02/29/2024

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

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 DEVMODEW fornecida pelo chamador.

dwLevel

Especifica um valor fornecido pelo chamador que indica o tipo de estrutura apontada 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 membro dwDrvXxx das estruturas ATTRIBUTE_INFO_N , o spooler pressupõe que o plug-in seja 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.

Retornar valor

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 a 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.

Comentários

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 de DDI DrvQueryJobAttributes do driver principal, conforme descrito na seção anterior.

Consulte DrvQueryJobAttributes para obter mais informações.