GetJobAttributesEx, fonction (winsplp.h)

Article
02/27/2024

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 de 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é vers pAttributeInfo, comme indiqué dans le tableau suivant. Pour plus d’informations, consultez la section Remarques ci-dessous.

valeur dwLevel	Structure pointée vers 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_3 ou ATTRIBUTE_INFO_4) qui reçoit des informations sur le travail 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 du niveau 1 jusqu’au niveau spécifié par dwLevel.

Par exemple, si dwLevel a la valeur 4 et que 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 = dmCopies membre de DEVMODEW

dwDrvNumberOfCopies = dmCopies membre de DEVMODEW

dwColorOptimization = 0

dmPrintQuality = membre dmPrintQuality de DEVMODEW

dmYResolution = membre dmYResolution de DEVMODEW

dwNupDirection = RIGHT_THEN_DOWN

dwBookletFlags = BOOKLET_EDGE_LEFT

dwDuplexFlags = 0

dwScalingPercentX = 100

dwScalingPercentY = 100

dwJobHandlingFlags = 0

Valeur retournée

GetJobAttributesEx retourne TRUE s’il réussit à obtenir les attributs du travail d’impression ; sinon, il 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), et continue à rechercher des niveaux de prise en charge progressivement inférieurs jusqu’à ce qu’il obtienne le niveau de support fourni par le pilote. Si dwFlags a la valeur FILL_WITH_DEFAULTS, la fonction remplit les valeurs par défaut pour les niveaux non pris en charge.