Função GetJobAttributesEx (winsplp.h)

Artigo
03/08/2023

Aviso

A partir do Windows 10, as APIs que dão suporte a provedores de impressão de terceiros foram preteridas. A Microsoft não recomenda nenhum investimento em provedores de impressão de terceiros. Além disso, em Windows 8 e produtos mais recentes em que o modelo de driver de impressão v4 está disponível, os provedores de impressão de terceiros podem não criar ou gerenciar filas que usam drivers de impressão v4.

A função GetJobAttributesEx de um provedor de impressão obtém informações sobre um trabalho de impressão, incluindo N-up e opções de impressão reversa.

Sintaxe

BOOL GetJobAttributesEx(
  [in]  LPWSTR     pPrinterName,
  [in]  LPDEVMODEW pDevmode,
  [in]  DWORD      dwLevel,
  [out] LPBYTE     pAttributeInfo,
  [in]  DWORD      nSize,
  [in]  DWORD      dwFlags
);

Parâmetros

[in] pPrinterName

Ponteiro fornecido pelo chamador para uma cadeia de caracteres Unicode terminada em NULL que contém o nome da impressora.

[in] pDevmode

Ponteiro fornecido pelo chamador para uma estrutura DEVMODEW que é passada para o processador de impressão ou driver de impressora.

[in] dwLevel

Valor fornecido pelo chamador que indica o tipo de estrutura apontado por pAttributeInfo, conforme indicado na tabela a seguir. Para obter mais informações, consulte a seção Comentários abaixo.

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

[out] pAttributeInfo

Ponteiro fornecido pelo chamador para uma estrutura de informações de atributo (ATTRIBUTE_INFO_1, ATTRIBUTE_INFO_2, ATTRIBUTE_INFO_3 ou ATTRIBUTE_INFO_4) que recebe informações sobre o trabalho de impressão.

[in] nSize

Tamanho do buffer, em bytes, apontado por pAttributeInfo.

[in] dwFlags

Se definido pelo chamador como FILL_WITH_DEFAULTS, o spooler preencherá pAttributeInfo com valores padrão do nível 1 até o nível especificado por dwLevel.

Por exemplo, se dwLevel for 4 e FILL_WITH_DEFAULTS for especificado, pAttributeInfo será preenchido com os seguintes valores de membro padrão de ATTRIBUTE_INFO_4:

dwJobNumberOfPagesPerSide = 1

dwDrvNumberOfPagesPerSide = 1

dwNupBorderFlags = 0

dwJobPageOrderFlags = 0

dwDrvPageOrderFlags = 0

dwJobNumberOfCopies = membro dmCopies de DEVMODEW

dwDrvNumberOfCopies = membro dmCopies de DEVMODEW

dwColorOptimization = 0

dmPrintQuality = dmPrintQuality membro de DEVMODEW

dmYResolution = membro dmYResolution de DEVMODEW

dwNupDirection = RIGHT_THEN_DOWN

dwBookletFlags = BOOKLET_EDGE_LEFT

dwDuplexFlags = 0

dwScalingPercentX = 100

dwScalingPercenty = 100

dwJobHandlingFlags = 0

Retornar valor

GetJobAttributesEx retornará TRUE se for bem-sucedido na obtenção dos atributos do trabalho de impressão; caso contrário, retornará FALSE.

Comentários

Essa função primeiro verifica se o driver dá suporte ao nível de atributo indicado por dwLevel. Se o driver não der suporte a esse nível de atributo, a função consultará o driver para obter suporte para o próximo nível inferior, (dwLevel - 1), e continuará consultando níveis progressivamente mais baixos de suporte até obter o nível de suporte fornecido pelo driver. Se dwFlags estiver definido como FILL_WITH_DEFAULTS, a função preencherá os valores padrão para os níveis sem suporte.