Función ControlPrintProcessor (winsplp.h)
La función ControlPrintProcessor de un procesador de impresión permite que el administrador de cola controle un trabajo de impresión.
Sintaxis
BOOL ControlPrintProcessor(
[in] HANDLE hPrintProcessor,
[in] DWORD Command
);
Parámetros
[in] hPrintProcessor
Controlador 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:
| Get-Help | 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.
Comentarios
Los procesadores de impresión son necesarios para exportar una función ControlPrintProcessor . El administrador de colas llama a la función cuando una aplicación llama a la función SetJob, descrita en la documentación de Microsoft Windows SDK.
En función del valor recibido para Command, 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 reanuda 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 | Value |
|---|---|
| Plataforma de destino | Escritorio |
| Encabezado | winsplp.h (incluya Winsplp.h) |
| Library | Nwprint.lib |