Função GetJobAttributesEx (winsplp.h)

Artigo
02/07/2025

Aviso

A partir do Windows 10, as APIs que dão suporte a provedores de impressão de terceiros são preteridas. A Microsoft não recomenda nenhum investimento em provedores de impressão de terceiros. Além disso, no Windows 8 e em 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 opções de impressão N-up e 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 por NULL que contém o nome da impressora.

[in] pDevmode

Ponteiro fornecido pelo chamador para uma estrutura deDEVMODEW 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 de 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_3ou 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ão preenchidos com os seguintes valores de membro padrão de ATTRIBUTE_INFO_4:

dwJobNumberOfPagesPerSide = 1

dwDrvNumberOfPagesPerSide = 1

dwNupBorderFlags = 0

dwJobPageOrderFlags = 0

dwDrvPageOrderFlags = 0

dwJobNumberOfCopies = dmCopies membro do DEVMODEW

dwDrvNumberOfCopies = dmCopies membro do DEVMODEW

dwColorOptimization = 0

dmPrintQuality = membro dmPrintQuality do DEVMODEW

dmYResolution = dmYResolution membro do DEVMODEW

dwNupDirection = RIGHT_THEN_DOWN

dwBookletFlags = BOOKLET_EDGE_LEFT

dwDuplexFlags = 0

dwScalingPercentX = 100

dwScalingPercentY = 100

dwJobHandlingFlags = 0

Valor de retorno

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

Observações

Essa função verifica primeiro 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 for definido como FILL_WITH_DEFAULTS, a função preencherá os valores padrão para os níveis sem suporte.