Funciones de la API del administrador de trabajos de impresión

La API Print Spooler contiene las funciones y estructuras de datos que las aplicaciones usan para administrar la cola de impresión de Windows y las impresoras y los trabajos de impresión que controla.

Las funciones de la API Print Spooler se dividen en los siguientes grupos:

• Funciones de trabajo de impresión
• Funciones de interfaz de usuario de impresora
• Funciones de impresora
• Funciones de notificación de cambio de impresora
• Funciones de formulario de impresora
• Funciones de administrador de trabajos de impresión

Funciones de trabajo de impresión

Estas funciones envían trabajos de impresión a una impresora y realizan un seguimiento y controlan los trabajos de impresión en la cola de impresión.

Función	Descripción
AddJob	La función AddJob agrega un trabajo de impresión a la lista de trabajos de impresión que el administrador de trabajos de impresión puede programar. La función recupera el nombre del archivo que puede usar para almacenar el trabajo.
ClosePrinter	La función ClosePrinter cierra el objeto de impresora especificado.
DocumentEvent	La función DocumentEvent es un controlador de eventos para eventos asociados a la impresión de un documento.
Documentproperties	La función DocumentProperties recupera o modifica la información de inicialización de la impresora o muestra una hoja de propiedades de configuración de impresora para la impresora especificada.
EndDocPrinter	La función EndDocPrinter finaliza un trabajo de impresión para la impresora especificada.
EndPagePrinter	La función EndPagePrinter notifica al administrador de trabajos de impresión que la aplicación está al final de una página en un trabajo de impresión.
EnumJobs	La función EnumJobs recupera información sobre un conjunto especificado de trabajos de impresión para una impresora especificada.
GetJob	La función GetJob recupera información sobre un trabajo de impresión especificado.
OpenPrinter	La función OpenPrinter recupera un identificador para la impresora o el servidor de impresión especificados u otros tipos de identificadores en el subsistema de impresión.
OpenPrinter2	Recupera un identificador de la impresora, el servidor de impresión u otros tipos de identificadores especificados en el subsistema de impresión, al tiempo que establece algunas de las opciones de impresora.
ReportJobProcessingProgress	Informa al servicio Print Spooler si un trabajo de impresión XPS está en cola o en la fase de representación y qué parte del procesamiento está actualmente en curso.
ScheduleJob	La función ScheduleJob solicita que el administrador de trabajos de impresión programe un trabajo de impresión especificado para imprimir.
SetJob	La función SetJob pausa, reanuda, cancela o reinicia un trabajo de impresión en una impresora especificada. También puede usar la función SetJob para establecer parámetros de trabajo de impresión, como la prioridad del trabajo de impresión y el nombre del documento.
StartDocPrinter	La función StartDocPrinter notifica al administrador de trabajos de impresión que se va a poner en cola un documento para imprimir.
StartPagePrinter	La función StartPagePrinter notifica al administrador de colas que una página está a punto de imprimirse en la impresora especificada.

Funciones de interfaz de usuario de impresora

Estas funciones muestran una interfaz de usuario que permite al usuario seleccionar o configurar una impresora.

Función	Descripción
AdvancedDocumentProperties	La función AdvancedDocumentProperties muestra un cuadro de diálogo de configuración de impresora para la impresora especificada, lo que permite al usuario configurar esa impresora.
ConfigurePort	La función ConfigurePort muestra el cuadro de diálogo configuración de puerto para un puerto en el servidor especificado.
ConnectToPrinterDlg	La función ConnectToPrinterDlg muestra un cuadro de diálogo que permite a los usuarios examinar y conectarse a impresoras de una red. Si el usuario selecciona una impresora, la función intenta crear una conexión a ella; Si un controlador adecuado no está instalado en el servidor, el usuario tiene la opción de crear una impresora localmente.
PrinterProperties	La función PrinterProperties muestra una hoja de propiedades de impresora para la impresora especificada.

Funciones de impresora

Estas funciones agregan y configuran las impresoras que usa el administrador de trabajos de impresión.

Función	Descripción
AbortPrinter	La función AbortPrinter elimina el archivo de cola de una impresora si la impresora está configurada para la cola.
Addprinter	La función AddPrinter agrega una impresora a la lista de impresoras admitidas para un servidor especificado.
AddPrinterConnection	La función AddPrinterConnection agrega una conexión a la impresora especificada para el usuario actual.
AddPrinterConnection2	Agrega una conexión a la impresora especificada para el usuario actual y especifica los detalles de conexión.
DeletePrinter	La función DeletePrinter elimina el objeto de impresora especificado.
DeletePrinterConnection	La función DeletePrinterConnection elimina una conexión a una impresora establecida por una llamada a AddPrinterConnection o ConnectToPrinterDlg.
DeletePrinterData	La función DeletePrinterData elimina los datos de configuración especificados para una impresora. Los datos de configuración de una impresora constan de un conjunto de valores con nombre y con tipo. La función DeletePrinterData elimina uno de estos valores, especificado por su nombre de valor.
DeletePrinterDataEx	La función DeletePrinterDataEx elimina un valor especificado de los datos de configuración de una impresora. Los datos de configuración de una impresora constan de un conjunto de valores con nombre y con tipo almacenados en una jerarquía de claves del Registro. La función elimina un valor especificado en una clave especificada.
DeletePrinterKey	La función DeletePrinterKey elimina una clave especificada y todas sus subclaves para una impresora especificada.
EnumPrinterData	La función EnumPrinterData enumera los datos de configuración de una impresora especificada.
EnumPrinterDataEx	La función EnumPrinterDataEx enumera todos los nombres de valor y los datos de una impresora y clave especificadas.
EnumPrinterKey	La función EnumPrinterKey enumera las subclaves de una clave especificada para una impresora especificada.
EnumPrinters	La función EnumPrinters enumera impresoras disponibles, servidores de impresión, dominios o proveedores de impresión.
FlushPrinter	La función FlushPrinter envía un búfer a la impresora para borrarlo de un estado transitorio.
GetDefaultPrinter	La función GetDefaultPrinter recupera el nombre de la impresora predeterminada para el usuario actual en el equipo local.
GetPrinter	La función GetPrinter recupera información sobre una impresora especificada.
GetPrinterData	La función GetPrinterData recupera los datos de configuración de la impresora o el servidor de impresión especificados.
GetPrinterDataEx	La función GetPrinterDataEx recupera los datos de configuración de la impresora o el servidor de impresión especificados. GetPrinterDataEx puede recuperar los valores almacenados por la función SetPrinterData . Además, GetPrinterDataEx puede recuperar valores almacenados en una clave especificada por la función SetPrinterDataEx .
IsValidDevmode	La función IsValidDevmode comprueba que el contenido de una estructura DEVMODE es válido.
ReadPrinter	La función ReadPrinter recupera datos de la impresora especificada.
ResetPrinter	La función ResetPrinter especifica los valores de tipo de datos y modo de dispositivo que se usarán para imprimir documentos enviados por la función StartDocPrinter . Estos valores se pueden invalidar mediante la función SetJob una vez iniciada la impresión de documentos.
SetDefaultPrinter	La función SetDefaultPrinter establece el nombre de la impresora predeterminada para el usuario actual en el equipo local.
SetPort	La función SetPort establece el estado asociado a un puerto de impresora.
SetPrinter	La función SetPrinter establece los datos de una impresora especificada o establece el estado de la impresora especificada pausando la impresión, reanudando la impresión o borrando todos los trabajos de impresión.
SetPrinterData	La función SetPrinterData establece los datos de configuración de una impresora o servidor de impresión.
SetPrinterDataEx	La función SetPrinterDataEx establece los datos de configuración de una impresora o servidor de impresión. La función almacena los datos de configuración en la clave del Registro de la impresora.
WritePrinter	La función WritePrinter notifica al administrador de trabajos de impresión que los datos se deben escribir en la impresora especificada.

Funciones de notificación de cambio de impresora

Estas funciones permiten que una aplicación reciba una notificación de los cambios en el estado de una impresora.

Función	Descripción
FindClosePrinterChangeNotification	La función FindClosePrinterChangeNotification cierra un objeto de notificación de cambio creado mediante una llamada a la función FindFirstPrinterChangeNotification . Ese objeto ya no supervisará la impresora o el servidor de impresión asociado al objeto de notificación de cambios.
FindFirstPrinterChangeNotification	La función FindFirstPrinterChangeNotification crea un objeto de notificación de cambio y devuelve un identificador al objeto . Después, puede usar este identificador en una llamada a una de las funciones de espera para supervisar los cambios en la impresora o el servidor de impresión.
FindNextPrinterChangeNotification	La función FindNextPrinterChangeNotification recupera información sobre la notificación de cambios más reciente de un objeto de notificación de cambio asociado a una impresora o servidor de impresión. Llame a esta función cuando se cumpla una operación de espera en el objeto de notificación de cambio.
FreePrinterNotifyInfo	La función FreePrinterNotifyInfo libera un búfer asignado por el sistema creado por la función FindNextPrinterChangeNotification .

Funciones de formulario de impresora

Estas funciones administran los formularios utilizados por una impresora.

Función	Descripción
AddForm	La función AddForm agrega un formulario a la lista de formularios disponibles que se pueden seleccionar para la impresora especificada.
DeleteForm	La función DeleteForm quita un nombre de formulario de la lista de formularios admitidos.
EnumForms	La función EnumForms enumera los formularios admitidos por la impresora especificada.
GetForm	La función GetForm recupera información sobre un formulario especificado.
SetForm	La función SetForm establece la información del formulario para la impresora especificada.

Funciones de administrador de trabajos de impresión

Estas funciones interactúan con el administrador de trabajos de impresión en un nivel bajo.

Función	Descripción
CloseSpoolFileHandle	La función CloseSpoolFileHandle cierra un identificador de un archivo de cola asociado al trabajo de impresión enviado actualmente por la aplicación.
CommitSpoolData	La función CommitSpoolData notifica al administrador de trabajos de impresión que se ha escrito una cantidad especificada de datos en un archivo de cola especificado y está listo para representarse.
GetPrintExecutionData	GetPrintExecutionData recupera el contexto de impresión actual.
GetSpoolFileHandle	La función GetSpoolFileHandle recupera un identificador para el archivo de cola asociado al trabajo enviado actualmente por la aplicación.