Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
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 UpdatePrintDeviceObject function updates the properties of a device object that is in the print provider queue.
Syntax
HRESULT UpdatePrintDeviceObject(
[in] HANDLE hPrinter,
[in] HANDLE hDeviceObject
);
Parameters
[in] hPrinter
The HANDLE to an open printer. This should be a handle that was returned by the AddPrinter or OpenPrinter spooler functions.
[in] hDeviceObject
The HANDLE to the device object to be updated. This should be a device object that was created with AddPrintDeviceObject.
Return value
The UpdatePrintDeviceObject function returns S_OK, if the properties of the device object were updated successfully. Otherwise it returns an error.
For example, this function can return HRESULT_FROM_WIN32(ERROR_INVALID_HANDLE), if the function call was made with an invalid HANDLE, or the device object was removed before the function call was made.
Remarks
The PRINTER_INFO_2 structure is a good example of the kind of properties that UpdatePrintDeviceObject can update.
Requirements
| Requirement | Value |
|---|---|
| Target Platform | Desktop |
| Header | winsplp.h (include Winspool.h) |
| Library | WinSpool.lib |
| DLL | WinSpool.drv |