RemovePrintDeviceObject function (winsplp.h)

Warning

Starting with Windows 10, the APIs which support third-party print providers are deprecated. Microsoft does not recommend any investment into third-party print providers. Additionally, on Windows 8 and newer products where the v4 print driver model is available, third-party print providers may not create or manage queues which use v4 print drivers.

The RemovePrintDeviceObject function removes a device object from a print provider queue.

Syntax

HRESULT RemovePrintDeviceObject(
  [in] HANDLE hDeviceObject
);

Parameters

[in] hDeviceObject

The HANDLE to the device object to be removed. This should be a device object that was created with AddPrintDeviceObject.

Return value

The RemovePrintDeviceObject function returns S_OK, if the device object was removed successfully. Otherwise it returns an error.

For example, this function can return HRESULT_FROM_WIN32(ERROR_INVALID_HANDLE), if an invalid device object handle was used to call the function. And note that, regardless of the return value, the device object HANDLE becomes invalid after a call to RemovePrintDeviceObject has completed.

Remarks

Call RemovePrintDeviceObject to remove the device object for a printer that has been deleted. When the spooler services stops, all the device objects are automatically deleted, so it is not required to call RemovePrintDeviceObject for each printer device object.

Requirements

Requirement Value
Target Platform Desktop
Header winsplp.h (include Winspool.h)
Library WinSpool.lib
DLL WinSpool.drv

See also

AddPrintDeviceObject