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

  • Статья

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

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

Функция RemovePrintDeviceObject удаляет объект устройства из очереди поставщика печати.

Синтаксис

HRESULT RemovePrintDeviceObject(
  [in] HANDLE hDeviceObject
);

Параметры

[in] hDeviceObject

Handle для удаляемого объекта устройства. Это должен быть объект устройства, созданный с помощью AddPrintDeviceObject.

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

Функция RemovePrintDeviceObject возвращает S_OK, если объект устройства был успешно удален. В противном случае возвращается ошибка.

Например, эта функция может возвращать HRESULT_FROM_WIN32(ERROR_INVALID_HANDLE), если для вызова функции использовался недопустимый дескриптор объекта устройства. Обратите внимание, что, независимо от возвращаемого значения, объект устройства HANDLE становится недопустимым после завершения вызова RemovePrintDeviceObject .

Комментарии

Вызовите Метод RemovePrintDeviceObject , чтобы удалить объект устройства для удаленного принтера. При остановке служб очереди очереди автоматически удаляются все объекты устройства, поэтому не требуется вызывать Метод RemovePrintDeviceObject для каждого объекта устройства принтера.

Требования

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

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

AddPrintDeviceObject