Función UpdatePrintDeviceObject (winsplp.h)
Advertencia
A partir de Windows 10, las API que admiten proveedores de impresión de terceros están en desuso. Microsoft no recomienda ninguna inversión en proveedores de impresión de terceros. Además, en Windows 8 y productos más recientes en los que el modelo de controlador de impresión v4 está disponible, es posible que los proveedores de impresión de terceros no creen o administren colas que usan controladores de impresión v4.
La función UpdatePrintDeviceObject actualiza las propiedades de un objeto de dispositivo que se encuentra en la cola del proveedor de impresión.
Sintaxis
HRESULT UpdatePrintDeviceObject(
[in] HANDLE hPrinter,
[in] HANDLE hDeviceObject
);
Parámetros
[in] hPrinter
Identificador de una impresora abierta. Debe ser un identificador devuelto por las funciones de AddPrinter o OpenPrinter spooler.
[in] hDeviceObject
Identificador del objeto de dispositivo que se va a actualizar. Debe ser un objeto de dispositivo que se creó con AddPrintDeviceObject.
Valor devuelto
La función UpdatePrintDeviceObject devuelve S_OK, si las propiedades del objeto de dispositivo se actualizaron correctamente. De lo contrario, devuelve un error.
Por ejemplo, esta función puede devolver HRESULT_FROM_WIN32(ERROR_INVALID_HANDLE), si la llamada a función se realizó con un IDENTIFICADOR no válido o el objeto de dispositivo se quitó antes de que se realizara la llamada de función.
Observaciones
La estructura PRINTER_INFO_2 es un buen ejemplo del tipo de propiedades que UpdatePrintDeviceObject puede actualizar.
Requisitos
| Requisito | Valor |
|---|---|
| de la plataforma de destino de | Escritorio |
| encabezado de | winsplp.h (include Winspool.h) |
| biblioteca de | WinSpool.lib |
| DLL de | WinSpool.drv |