Funzione GetJobAttributesEx (winsplp.h)

Articolo
08/08/2023

Avviso

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 Windows 8 e nei prodotti più recenti 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 inversa e su N.

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 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_3 o 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 fino al livello specificato da dwLevel.

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

dwJobNumberOfPagesPerSide = 1

dwDrvNumberOfPagesPerSide = 1

dwNupBorderFlags = 0

dwJobPageOrderFlags = 0

dwDrvPageOrderFlags = 0

dwJobNumberOfCopies = membro dmCopies di DEVMODEW

dwDrvNumberOfCopies = membro dmCopies di DEVMODEW

dwColorOptimization = 0

dmPrintQuality = membro dmPrintQuality di DEVMODEW

dmYResolution = membro dmYResolution 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.

Commenti

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 una 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.