Función ScheduleJob

La función ScheduleJob solicita que el administrador de trabajos de impresión programe un trabajo de impresión especificado para la impresión.

Sintaxis

BOOL ScheduleJob(
  _In_ HANDLE hPrinter,
  _In_ DWORD  dwJobID
);

Parámetros

hPrinter [in]

Identificador de la impresora para el trabajo de impresión. Debe ser una impresora local que esté configurada como una impresora en cola. Si hPrinter es un identificador para una conexión de impresora remota o si la impresora está configurada para la impresión directa, se produce un error en la función ScheduleJob . Use la función OpenPrinter o AddPrinter para recuperar un identificador de impresora.

hPrinter debe ser el mismo identificador de impresora especificado en la llamada a AddJob que obtuvo el identificador del trabajo de impresión dwJobID .

dwJobID [in]

Trabajo de impresión que se va a programar. Para obtener este identificador de trabajo de impresión, llame a la función AddJob .

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es un valor distinto de cero.

Si la función no se realiza correctamente, el valor devuelto es cero.

Comentarios

Nota

Se trata de una función de bloqueo o sincrónica que podría no devolverse inmediatamente. La rapidez con la que devuelve esta función depende de factores en tiempo de ejecución, como el estado de red, la configuración del servidor de impresión y los factores de implementación del controlador de impresora que son difíciles de predecir al escribir una aplicación. Llamar a esta función desde un subproceso que administra la interacción con la interfaz de usuario podría hacer que la aplicación parezca que no responde.

Debe llamar correctamente a la función AddJob antes de llamar a la función ScheduleJob . AddJob obtiene el identificador del trabajo de impresión que se pasa a ScheduleJob como dwJobID. Ambas llamadas deben usar el mismo valor para hPrinter.

La función ScheduleJob comprueba si hay un archivo de cola válido. Si hay un archivo de cola no válido o si está vacío, ScheduleJob elimina tanto el archivo de cola como la entrada de trabajo de impresión correspondiente en el administrador de trabajos de impresión.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Encabezado	Winspool.h (incluye Windows.h)
Biblioteca	Winspool.lib
Archivo DLL	Spoolss.dll

Consulte también

Impresión

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

AddJob

OpenPrinter