Função ControlPrintProcessor (winsplp.h)

  • Artigo

A função ControlPrintProcessor de um processador de impressão permite que o spooler controle um trabalho de impressão.

Sintaxe

BOOL ControlPrintProcessor(
  [in] HANDLE hPrintProcessor,
  [in] DWORD  Command
);

Parâmetros

[in] hPrintProcessor

Identificador do processador de impressão fornecido pelo chamador. Esse é o identificador retornado por uma chamada anterior para OpenPrintProcessor.

[in] Command

Comando fornecido pelo chamador que indica o tipo de operação a ser executada. Os seguintes comandos são válidos:

Comando Definição
JOB_CONTROL_CANCEL A função deve cancelar o trabalho de impressão atual.
JOB_CONTROL_PAUSE A função deve pausar o trabalho de impressão atual.
JOB_CONTROL_RESUME A função deve retomar o trabalho de impressão atual.

Retornar valor

Se a operação for bem-sucedida, a função deverá retornar TRUE. Se a operação falhar, a função deverá chamar SetLastError para definir um código de erro e retornar FALSE.

Comentários

Processadores de impressão são necessários para exportar uma função ControlPrintProcessor . O spooler chama a função quando um aplicativo chama a função SetJob, descrita na documentação do SDK do Microsoft Windows.

Com base no valor recebido para Command, a função deve pausar, retomar ou cancelar o trabalho atual. A função ControlPrintProcessor pode ser chamada de forma assíncrona enquanto a função PrintDocumentOnPrintProcessor do processador de impressão está em execução. Portanto, algum tipo de técnica de sincronização deve ser empregada, como definir um objeto de evento definido internamente para pausar um trabalho e redefinir o objeto de evento quando o trabalho for retomado. A função ControlPrintProcessor pode retornar rapidamente após definir ou redefinir o objeto de evento, e PrintDocumentOnPrintProcessor pode aguardar até que o evento esteja no estado adequado.

Requisitos

Requisito Valor
Plataforma de Destino Área de Trabalho
Cabeçalho winsplp.h (inclua Winsplp.h)
Biblioteca Nwprint.lib

Confira também

OpenPrintProcessor

PrintDocumentOnPrintProcessor