Функция GetJobAttributesEx (winsplp.h)

Статья
08/08/2023

Предупреждение

Начиная с Windows 10 api, которые поддерживают сторонних поставщиков печати, являются устаревшими. Корпорация Майкрософт не рекомендует инвестировать в сторонних поставщиков печати. Кроме того, в Windows 8 и более новых продуктах, где доступна модель драйвера печати версии 4, сторонние поставщики печати не могут создавать очереди, использующие драйверы печати версии 4, или управлять ими.

Функция GetJobAttributesEx поставщика печати получает сведения о задании печати, включая параметры N-up и обратной печати.

Синтаксис

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

Параметры

[in] pPrinterName

Предоставленный вызывающим элементом указатель на строку Юникода, завершающуюся null, которая содержит имя принтера.

[in] pDevmode

Предоставленный вызывающим элементом указатель на структуру DEVMODEW , которая передается в процессор печати или драйвер принтера.

[in] dwLevel

Значение вызывающего объекта, указывающее тип структуры, на которую указывает pAttributeInfo, как показано в следующей таблице. Дополнительные сведения см. в разделе Примечания ниже.

Значение dwLevel	Структура, на которую указывает pAttributeInfo
1	ATTRIBUTE_INFO_1
2	ATTRIBUTE_INFO_2
3	ATTRIBUTE_INFO_3
4	ATTRIBUTE_INFO_4

[out] pAttributeInfo

Предоставляемый вызывающим элементом указатель на структуру сведений об атрибутах (ATTRIBUTE_INFO_1, ATTRIBUTE_INFO_2, ATTRIBUTE_INFO_3 или ATTRIBUTE_INFO_4), которая получает сведения о задании печати.

[in] nSize

Размер буфера в байтах, на который указывает pAttributeInfo.

[in] dwFlags

Если вызывающим объектом задано значение FILL_WITH_DEFAULTS, модуль очереди очереди будет заполнять pAttributeInfo значениями по умолчанию от уровня 1 до уровня, заданного dwLevel.

Например, если параметр dwLevel равен 4 и указан FILL_WITH_DEFAULTS, pAttributeInfo будет заполнен следующими значениями элементов по умолчанию ATTRIBUTE_INFO_4:

dwJobNumberOfPagesPerSide = 1

dwDrvNumberOfPagesPerSide = 1

dwNupBorderFlags = 0

dwJobPageOrderFlags = 0

dwDrvPageOrderFlags = 0

dwJobNumberOfCopies = Член dmCopiesв DEVMODEW

dwDrvNumberOfCopies = Член dmCopiesв DEVMODEW

dwColorOptimization = 0

dmPrintQuality = Член dmPrintQualityв DEVMODEW

dmYResolution = Член dmYResolutionв DEVMODEW

dwNupDirection = RIGHT_THEN_DOWN

dwBookletFlags = BOOKLET_EDGE_LEFT

dwDuplexFlags = 0

dwScalingPercentX = 100

dwScalingPercentY = 100

dwJobHandlingFlags = 0

Возвращаемое значение

GetJobAttributesEx возвращает значение TRUE , если он успешно получает атрибуты задания печати; В противном случае возвращается значение FALSE.

Эта функция сначала проверяет, поддерживает ли драйвер уровень атрибута, указанный dwLevel. Если драйвер не поддерживает этот уровень атрибутов, функция запрашивает у драйвера поддержку следующего нижнего уровня (dwLevel — 1) и продолжает запрашивать постепенно более низкие уровни поддержки, пока не получит уровень поддержки, предоставляемый драйвером. Если параметр dwFlags имеет значение FILL_WITH_DEFAULTS, функция заполняет значения по умолчанию для неподдерживаемых уровней.

Требования

Требование	Значение
Целевая платформа	Персональный компьютер
Верхняя часть	winsplp.h (включая Winsplp.h)
Библиотека	Spoolss.lib
DLL	Spoolss.dll

См. также раздел

Поделиться через