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 ni administren colas que usen 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 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 de función se realizó con un HANDLE no válido o el objeto de dispositivo se quitó antes de que se realizara la llamada a la función.
Comentarios
La estructura PRINTER_INFO_2 es un buen ejemplo del tipo de propiedades que UpdatePrintDeviceObject puede actualizar.
Requisitos
| Requisito | Value |
|---|---|
| Plataforma de destino | Escritorio |
| Encabezado | winsplp.h (incluya Winspool.h) |
| Library | WinSpool.lib |
| Archivo DLL | WinSpool.drv |