RemovePrintDeviceObject 函数 (winsplp.h)

警告

从Windows 10开始，支持第三方打印提供程序的 API 已弃用。 Microsoft 不建议对第三方打印提供商进行任何投资。此外，在提供 v4 打印驱动程序模型的Windows 8和较新的产品上，第三方打印提供程序不得创建或管理使用 v4 打印驱动程序的队列。

RemovePrintDeviceObject 函数从打印提供程序队列中删除设备对象。

语法

HRESULT RemovePrintDeviceObject(
  [in] HANDLE hDeviceObject
);

[in] hDeviceObject

要删除的设备对象的 HANDLE。这应该是使用 AddPrintDeviceObject 创建的设备对象。

如果成功删除设备对象， RemovePrintDeviceObject 函数将返回S_OK。否则它将返回错误。

例如，如果使用无效的设备对象句柄调用函数，则此函数可以返回HRESULT_FROM_WIN32 (ERROR_INVALID_HANDLE) 。请注意，无论返回值如何，设备对象 HANDLE 在 对 RemovePrintDeviceObject 的调用完成后变为无效。

调用 RemovePrintDeviceObject 以删除已删除的打印机的设备对象。后台处理程序服务停止时，将自动删除所有设备对象，因此无需为每个打印机设备对象调用 RemovePrintDeviceObject 。