Función UpdatePrintDeviceObject (winsplp.h)

  • Artículo

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

Consulte también

AddPrintDeviceObject

PRINTER_INFO_2