Функция 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, то spooler заполняет 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 (include Winsplp.h) |
| библиотеки | Spoolss.lib |
| DLL | Spoolss.dll |