Функция GetJobAttributesEx (winsplp.h)
Предупреждение
Начиная с 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 |