GetJobAttributesEx, fonction (winsplp.h)
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.
Configuration requise
Condition requise | Valeur |
---|---|
Plateforme cible | Desktop (Expérience utilisateur) |
En-tête | winsplp.h (inclure Winsplp.h) |
Bibliothèque | Spoolss.lib |
DLL | Spoolss.dll |