Função ControlPrintProcessor (winsplp.h)

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:

Valor de retorno

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

Observações

Os 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 comando, 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á sendo executada. 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 o evento estar no estado adequado.

Requisitos

Consulte também

OpenPrintProcessor

printDocumentOnPrintProcessor