Função OpenPrintProcessor (winsplp.h)

Artigo
02/27/2024

A função de um processador de OpenPrintProcessor 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 PRINTPROCESSOROPENDATA .

Retornar valor

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

Comentários

Processadores de impressão são necessários para exportar uma OpenPrintProcessor função. 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 antes 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 DEVMODEW da impressora, ambos recebidos na estrutura PRINTPROCESSOROPENDATA . 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.