Funzione GetJobAttributesEx (winsplp.h)

Articolo
02/07/2025

Avvertimento

A partire da Windows 10, le API che supportano provider di stampa di terze parti sono deprecate. Microsoft non consiglia alcun investimento in provider di stampa di terze parti. Inoltre, nei prodotti Windows 8 e versioni successive in cui è disponibile il modello di driver di stampa v4, i provider di stampa di terze parti potrebbero non creare o gestire code che usano driver di stampa v4.

La funzione GetJobAttributesEx di un provider di stampa ottiene informazioni su un processo di stampa, incluse le opzioni di stampa N e inversa.

Sintassi

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

Parametri

[in] pPrinterName

Puntatore fornito dal chiamante a una stringa Unicode con terminazione NULL contenente il nome della stampante.

[in] pDevmode

Puntatore fornito dal chiamante a una struttura DEVMODEW passata al driver del processore di stampa o della stampante.

[in] dwLevel

Valore fornito dal chiamante che indica il tipo di struttura a cui punta pAttributeInfo, come indicato nella tabella seguente. Per altre informazioni, vedere la sezione osservazioni di seguito.

valore di dwLevel	Struttura a cui punta pAttributeInfo
1	ATTRIBUTE_INFO_1
2	ATTRIBUTE_INFO_2
3	ATTRIBUTE_INFO_3
4	ATTRIBUTE_INFO_4

[out] pAttributeInfo

Puntatore fornito dal chiamante a una struttura di informazioni sugli attributi (ATTRIBUTE_INFO_1, ATTRIBUTE_INFO_2, ATTRIBUTE_INFO_3o ATTRIBUTE_INFO_4) che riceve informazioni sul processo di stampa.

[in] nSize

Dimensioni del buffer, in byte, a cui punta pAttributeInfo.

[in] dwFlags

Se impostato dal chiamante su FILL_WITH_DEFAULTS, lo spooler riempie pAttributeInfo con valori predefiniti dal livello 1 al livello specificato da dwLevel.

Ad esempio, se dwLevel è 4 e FILL_WITH_DEFAULTS viene specificato, pAttributeInfo verrà riempito con i valori di membro predefiniti seguenti di ATTRIBUTE_INFO_4:

dwJobNumberOfPagesPerSide = 1

dwDrvNumberOfPagesPerSide = 1

dwNupBorderFlags = 0

dwJobPageOrderFlags = 0

dwDrvPageOrderFlags = 0

dwJobNumberOfCopies = membro di DEVMODEW

dwDrvNumberOfCopies = membro dmCopies di DEVMODEW

dwColorOptimization = 0

dmPrintQuality = membro dmPrintQuality di DEVMODEW

= dmYResolution membro di DEVMODEW

dwNupDirection = RIGHT_THEN_DOWN

dwBookletFlags = BOOKLET_EDGE_LEFT

dwDuplexFlags = 0

dwScalingPercentX = 100

dwScalingPercentY = 100

dwJobHandlingFlags = 0

Valore restituito

GetJobAttributesEx restituisce TRUE se riesce a ottenere gli attributi del processo di stampa; in caso contrario, restituisce FALSE.

Osservazioni

Questa funzione controlla innanzitutto se il driver supporta il livello di attributo indicato da dwLevel. Se il driver non supporta tale livello di attributo, la funzione esegue una query sul driver per il supporto per il livello inferiore successivo, (dwLevel - 1) e continua a eseguire query per ottenere livelli di supporto progressivamente inferiori fino a ottenere il livello di supporto fornito dal driver. Se dwFlags è impostato su FILL_WITH_DEFAULTS, la funzione compila i valori predefiniti per i livelli non supportati.