GetJobAttributesEx-Funktion (winsplp.h)

Artikel
02/07/2025

Warnung

Ab Windows 10 sind die APIs, die Druckanbieter von Drittanbietern unterstützen, veraltet. Microsoft empfiehlt keine Investition in Druckanbieter von Drittanbietern. Darüber hinaus können Drittanbieter unter Windows 8 und neueren Produkten, bei denen das v4-Drucktreibermodell verfügbar ist, keine Warteschlangen erstellen oder verwalten, die v4-Drucktreiber verwenden.

Die GetJobAttributesEx-Funktion eines Druckanbieters ruft Informationen zu einem Druckauftrag ab, einschließlich N-up- und Reversedruckoptionen.

Syntax

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

Parameter

[in] pPrinterName

Vom Aufrufer bereitgestellter Zeiger auf eine MIT NULL beendete Unicode-Zeichenfolge, die den Druckernamen enthält.

[in] pDevmode

Vom Aufrufer bereitgestellter Zeiger auf eine DEVMODEW- Struktur, die an den Druckprozessor oder Druckertreiber übergeben wird.

[in] dwLevel

Vom Aufrufer bereitgestellter Wert, der den Typ der Struktur angibt, auf die pAttributeInfoverweist, wie in der folgenden Tabelle angegeben. Weitere Informationen finden Sie im Abschnitt Anmerkungen weiter unten.

dwLevel Wert	Struktur, auf die von pAttributeInfo- verwiesen wird
1	ATTRIBUTE_INFO_1
2	ATTRIBUTE_INFO_2
3	ATTRIBUTE_INFO_3
4	ATTRIBUTE_INFO_4

[out] pAttributeInfo

Vom Aufrufer bereitgestellter Zeiger auf eine Attributinformationsstruktur (ATTRIBUTE_INFO_1, ATTRIBUTE_INFO_2, ATTRIBUTE_INFO_3oder ATTRIBUTE_INFO_4), die Informationen über den Druckauftrag empfängt.

[in] nSize

Die Größe des Puffers in Bytes, auf die durch pAttributeInfoverwiesen wird.

[in] dwFlags

Wenn der Aufrufer auf FILL_WITH_DEFAULTS festgelegt wird, füllt der Spooler pAttributeInfo mit Standardwerten von Ebene 1 bis zur ebene, die durch dwLevelangegeben wird.

Wenn beispielsweise dwLevel 4 ist und FILL_WITH_DEFAULTS angegeben wird, wird pAttributeInfo- mit den folgenden Standardwerten von ATTRIBUTE_INFO_4gefüllt:

dwJobNumberOfPagesPerSide = 1

dwDrvNumberOfPagesPerSide = 1

dwNupBorderFlags = 0

dwJobPageOrderFlags = 0

dwDrvPageOrderFlags = 0

dwJobNumberOfCopies = dmCopies Mitglied von DEVMODEW

dwDrvNumberOfCopies = dmCopies Mitglied von DEVMODEW

dwColorOptimization = 0

dmPrintQuality = dmPrintQuality Mitglied von DEVMODEW

dmYResolution = dmYResolution Mitglied von DEVMODEW

dwNupDirection = RIGHT_THEN_DOWN

dwBookletFlags = BOOKLET_EDGE_LEFT

dwDuplexFlags = 0

dwScalingPercentX = 100

dwScalingPercentY = 100

dwJobHandlingFlags = 0

Rückgabewert

GetJobAttributesEx- gibt TRUE zurück, wenn die Attribute des Druckauftrags erfolgreich abgerufen werden; andernfalls wird FALSE-zurückgegeben.

Bemerkungen

Diese Funktion überprüft zunächst, ob der Treiber die Attributebene unterstützt, die durch dwLevelangegeben wird. Wenn der Treiber diese Attributebene nicht unterstützt, fragt die Funktion den Treiber nach Unterstützung für die nächste untere Ebene ab (dwLevel - 1), und fragt weiterhin nach progressiven niedrigeren Unterstützungsebenen ab, bis er die vom Treiber bereitgestellte Unterstützungsebene abruft. Wenn dwFlags- auf FILL_WITH_DEFAULTS festgelegt ist, füllt die Funktion die Standardwerte für die nicht unterstützten Ebenen aus.