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