GetJobAttributesEx-Funktion (winsplp.h)

Artikel
08/08/2023

Warnung

Ab Windows 10 sind die APIs, die Druckanbieter von Drittanbietern unterstützen, veraltet. Microsoft empfiehlt keine Investitionen in Druckdienstleister von Drittanbietern. Bei Windows 8 und neueren Produkten, bei denen das v4-Drucktreibermodell verfügbar ist, können Druckanbieter von Drittanbietern möglicherweise 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 endende 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 pAttributeInfo verweist, wie in der folgenden Tabelle angegeben. Weitere Informationen finden Sie weiter unten im Abschnitt "Hinweise" .

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_3 oder ATTRIBUTE_INFO_4), die Informationen über den Druckauftrag empfängt.

[in] nSize

Größe des Puffers in Bytes, auf den pAttributeInfo verweist.

[in] dwFlags

Wenn vom Aufrufer auf FILL_WITH_DEFAULTS festgelegt wird, füllt der Spooler pAttributeInfo mit Standardwerten von Ebene 1 bis zu der von dwLevel angegebenen Ebene aus.

Wenn z. B. dwLevel den Wert 4 aufweist und FILL_WITH_DEFAULTS angegeben ist, wird pAttributeInfo mit den folgenden Standardmemberwerten von ATTRIBUTE_INFO_4 gefü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 Druckauftragsattribute erfolgreich abgerufen werden. Andernfalls wird FALSE zurückgegeben.

Hinweise

Diese Funktion überprüft zunächst, ob der Treiber die durch dwLevel angegebene Attributebene unterstützt. Wenn der Treiber diese Attributebene nicht unterstützt, fragt die Funktion den Treiber nach Unterstützung für die nächstniedrige Ebene (dwLevel - 1) ab und fragt nach schrittweise niedrigeren Supportebenen ab, bis sie die vom Treiber bereitgestellte Unterstützungsebene erhält. Wenn dwFlags auf FILL_WITH_DEFAULTS festgelegt ist, füllt die Funktion die Standardwerte für die nicht unterstützten Ebenen aus.