Функция UpdatePrintDeviceObject (winsplp.h)
Предупреждение
Начиная с Windows 10 api, которые поддерживают сторонних поставщиков печати, являются устаревшими. Корпорация Майкрософт не рекомендует инвестировать в сторонних поставщиков печати. Кроме того, в Windows 8 и более новых продуктах, где доступна модель драйвера печати версии 4, сторонние поставщики печати не могут создавать очереди, использующие драйверы печати версии 4, или управлять ими.
Функция UpdatePrintDeviceObject обновляет свойства объекта устройства, который находится в очереди поставщика печати.
Синтаксис
HRESULT UpdatePrintDeviceObject(
[in] HANDLE hPrinter,
[in] HANDLE hDeviceObject
);
Параметры
[in] hPrinter
Дескриптор для открытого принтера. Это должен быть дескриптор, возвращенный функциями очереди AddPrinter или OpenPrinter .
[in] hDeviceObject
Handle для обновляемого объекта устройства. Это должен быть объект устройства, созданный с помощью AddPrintDeviceObject.
Возвращаемое значение
Функция UpdatePrintDeviceObject возвращает S_OK, если свойства объекта устройства были успешно обновлены. В противном случае возвращается ошибка.
Например, эта функция может возвращать HRESULT_FROM_WIN32(ERROR_INVALID_HANDLE), если вызов функции был выполнен с недопустимым HANDLE или объект устройства был удален до вызова функции.
Комментарии
Структура PRINTER_INFO_2 является хорошим примером типов свойств, которые может обновлять UpdatePrintDeviceObject .
Требования
| Требование | Значение |
|---|---|
| Целевая платформа | Персональный компьютер |
| Верхняя часть | winsplp.h (включая Winspool.h) |
| Библиотека | WinSpool.lib |
| DLL | Winspool.drv |