Función RemovePrintDeviceObject (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 o administren colas que usen controladores de impresión v4.

La función RemovePrintDeviceObject quita un objeto de dispositivo de una cola del proveedor de impresión.

Sintaxis

HRESULT RemovePrintDeviceObject(
  [in] HANDLE hDeviceObject
);

Parámetros

[in] hDeviceObject

Identificador del objeto de dispositivo que se va a quitar. Debe ser un objeto de dispositivo que se creó con AddPrintDeviceObject.

Valor devuelto

La función RemovePrintDeviceObject devuelve S_OK, si el objeto de dispositivo se quitó correctamente. De lo contrario, devuelve un error.

Por ejemplo, esta función puede devolver HRESULT_FROM_WIN32(ERROR_INVALID_HANDLE), si se usó un identificador de objeto de dispositivo no válido para llamar a la función. Tenga en cuenta que, independientemente del valor devuelto, el identificador del objeto de dispositivo deja de ser válido después de que se haya completado una llamada a RemovePrintDeviceObject .

Comentarios

Llame a RemovePrintDeviceObject para quitar el objeto de dispositivo de una impresora que se haya eliminado. Cuando se detiene el servicio de cola, todos los objetos de dispositivo se eliminan automáticamente, por lo que no es necesario llamar a RemovePrintDeviceObject para cada objeto de dispositivo de impresora.

Requisitos

Requisito Value
Plataforma de destino Escritorio
Encabezado winsplp.h (incluya Winspool.h)
Library WinSpool.lib
Archivo DLL WinSpool.drv

Consulte también

AddPrintDeviceObject