Función ControlPrintProcessor (winsplp.h)
La función ControlPrintProcessor de un procesador de impresión permite que el administrador de trabajos de impresión controle un trabajo de impresión.
Sintaxis
BOOL ControlPrintProcessor(
[in] HANDLE hPrintProcessor,
[in] DWORD Command
);
Parámetros
[in] hPrintProcessor
Controlador de procesador de impresión proporcionado por el autor de la llamada. Este es el identificador devuelto por una llamada anterior a OpenPrintProcessor.
[in] Command
Comando proporcionado por el autor de la llamada que indica el tipo de operación que se va a realizar. Los siguientes comandos son válidos:
| Mandar | Definición |
|---|---|
| JOB_CONTROL_CANCEL | La función debe cancelar el trabajo de impresión actual. |
| JOB_CONTROL_PAUSE | La función debe pausar el trabajo de impresión actual. |
| JOB_CONTROL_RESUME | La función debe reanudar el trabajo de impresión actual. |
Valor devuelto
Si la operación se realiza correctamente, la función debe devolver TRUE. Si se produce un error en la operación, la función debe llamar a SetLastError para establecer un código de error y, a continuación, devolver FALSE.
Observaciones
Los procesadores de impresión son necesarios para exportar una función controlPrintProcessor. El colador llama a la función cuando una aplicación llama a la función SetJob, que se describe en la documentación del SDK de Microsoft Windows.
En función del valor recibido para Comando, la función debe pausar, reanudar o cancelar el trabajo actual. La función ControlPrintProcessor se puede llamar de forma asincrónica mientras se ejecuta la función printDocumentOnPrintProcessor del procesador de impresión. Por lo tanto, se debe emplear algún tipo de técnica de sincronización, como establecer un objeto de evento definido internamente para pausar un trabajo y restablecer el objeto de evento cuando se reanude el trabajo. La función ControlPrintProcessor puede devolver rápidamente después de establecer o restablecer el objeto de evento, y PrintDocumentOnPrintProcessor puede esperar a que el evento esté en el estado adecuado.
Requisitos
| Requisito | Valor |
|---|---|
| de la plataforma de destino de | Escritorio |
| encabezado de | winsplp.h (incluya Winsplp.h) |
| biblioteca de | Nwprint.lib |