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
| Requisito | Valor |
|---|---|
| da Plataforma de Destino | Área de trabalho |
| cabeçalho | winsplp.h (inclua Winsplp.h) |
| biblioteca | Nwprint.lib |