GetJobAttributesEx, fonction (winsplp.h)

Article
02/07/2025

Avertissement

À compter de Windows 10, les API qui prennent en charge les fournisseurs d’impression tiers sont déconseillées. Microsoft ne recommande aucun investissement dans des fournisseurs d’impression tiers. En outre, sur windows 8 et les produits plus récents où le modèle de pilote d’impression v4 est disponible, les fournisseurs d’impression tiers peuvent ne pas créer ou gérer des files d’attente qui utilisent des pilotes d’impression v4.

La fonction GetJobAttributesEx d’un fournisseur d’impression obtient des informations sur un travail d’impression, y compris les options d’impression N-up et d’impression inversée.

Syntaxe

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

Paramètres

[in] pPrinterName

Pointeur fourni par l’appelant vers une chaîne Unicode terminée par NULL qui contient le nom de l’imprimante.

[in] pDevmode

Pointeur fourni par l’appelant vers une structure DEVMODEW transmise au processeur d’impression ou au pilote d’imprimante.

[in] dwLevel

Valeur fournie par l’appelant qui indique le type de structure pointé par pAttributeInfo, comme indiqué dans le tableau suivant. Pour plus d’informations, consultez la section Remarques ci-dessous.

valeur de dwLevel	Structure pointée par pAttributeInfo
1	ATTRIBUTE_INFO_1
2	ATTRIBUTE_INFO_2
3	ATTRIBUTE_INFO_3
4	ATTRIBUTE_INFO_4

[out] pAttributeInfo

Pointeur fourni par l’appelant vers une structure d’informations d’attribut (ATTRIBUTE_INFO_1, ATTRIBUTE_INFO_2, ATTRIBUTE_INFO_3ou ATTRIBUTE_INFO_4) qui reçoit des informations sur la tâche d’impression.

[in] nSize

Taille de la mémoire tampon, en octets, pointée par pAttributeInfo.

[in] dwFlags

Si l’appelant est défini sur FILL_WITH_DEFAULTS, le spouleur remplit pAttributeInfo avec les valeurs par défaut comprises entre le niveau 1 et le niveau spécifié par dwLevel.

Par exemple, si dwLevel est 4 et FILL_WITH_DEFAULTS est spécifié, pAttributeInfo est rempli avec les valeurs membres par défaut suivantes de ATTRIBUTE_INFO_4:

dwJobNumberOfPagesPerSide = 1

dwDrvNumberOfPagesPerSide = 1

dwNupBorderFlags = 0

dwJobPageOrderFlags = 0

dwDrvPageOrderFlags = 0

dwJobNumberOfCopies = membre dmCopies de DEVMODEW

dwDrvNumberOfCopies = membre dmCopies de DEVMODEW

dwColorOptimization = 0

membre dmPrintQuality = dmPrintQuality membre de DEVMODEW

dmYResolution = dmYResolution membre de DEVMODEW

dwNupDirection = RIGHT_THEN_DOWN

dwBookletFlags = BOOKLET_EDGE_LEFT

dwDuplexFlags = 0

dwScalingPercentX = 100

dwScalingPercentY = 100

dwJobHandlingFlags = 0

Valeur de retour

GetJobAttributesEx retourne TRUE si elle réussit à obtenir les attributs du travail d’impression ; sinon, elle retourne FALSE.

Remarques

Cette fonction vérifie d’abord si le pilote prend en charge le niveau d’attribut indiqué par dwLevel. Si le pilote ne prend pas en charge ce niveau d’attribut, la fonction interroge le pilote pour la prise en charge du niveau inférieur suivant (dwLevel - 1), puis continue à rechercher des niveaux de prise en charge progressivement inférieurs jusqu’à ce qu’il obtienne le niveau de prise en charge fourni par le pilote. Si dwFlags est défini sur FILL_WITH_DEFAULTS, la fonction remplit les valeurs par défaut pour les niveaux non pris en charge.