Função OpenPrintProcessor (winsplp.h)

A função OpenPrintProcessor de um processador de impressão prepara o processador de impressão para imprimir um trabalho e retorna um identificador.

Sintaxe

HANDLE OpenPrintProcessor(
  [in] LPWSTR                  pPrinterName,
  [in] PPRINTPROCESSOROPENDATA pPrintProcessorOpenData
);

Parâmetros

[in] pPrinterName

Ponteiro fornecido pelo chamador para o nome da impressora para a qual o processador de impressão está sendo aberto.

[in] pPrintProcessorOpenData

Ponteiro fornecido pelo chamador para uma estrutura de PRINTPROCESSOROPENDATA.

Valor de retorno

Se a operação for bem-sucedida, a função deverá retornar um identificador que pode ser usado como argumento de entrada para chamadas subsequentes para PrintDocumentOnPrintProcessor, ControlPrintProcessore ClosePrintProcessor. Se a operação falhar, a função deverá chamar SetLastError para definir um código de erro e retornar NULL.

Observações

Os processadores de impressão são necessários para exportar uma função OpenPrintProcessor. O spooler chama a função quando um trabalho de impressão está disponível. A função deve executar operações de inicialização necessárias para que um trabalho possa ser processado, com base no tipo de dados do trabalho.

A função deve retornar um identificador. Normalmente, o identificador é um ponteiro para uma estrutura interna. A estrutura deve conter um ponteiro para o nome da impressora e um ponteiro para a estrutura de DEVMODEW da impressora, ambas recebidas na estrutura PRINTPROCESSOROPENDATA da. Esses dois ponteiros são exigidos pela função PrintDocumentOnPrintProcessor do processador de impressão e essa última função recebe o identificador como entrada quando o spooler o chama.

Requisitos

Consulte também

ClosePrintProcessor

ControlPrintProcessor

PRINTPROCESSOROPENDATA

printDocumentOnPrintProcessor