Método IPrintOemUI::P rinterEvent (prcomoem.h)

Artigo
02/07/2025

O método IPrintOemUI::PrinterEvent permite que um plug-in de interface do usuário processe eventos de impressora.

Sintaxe

HRESULT PrinterEvent(
  PWSTR  pPrinterName,
  INT    iDriverEvent,
  DWORD  dwFlags,
  LPARAM lParam
);

Parâmetros

pPrinterName

Ponteiro fornecido pelo chamador para uma cadeia de caracteres de nome de impressora terminada em NULL. A cadeia de caracteres pode identificar uma impressora local ("PrinterName") ou impressora remota ("\Machine\PrinterName").

iDriverEvent

Valor fornecido pelo chamador que identifica o evento que ocorreu. Para obter uma lista de valores válidos, consulte DrvPrinterEvent.

dwFlags

Sinalizadores fornecidos pelo chamador. Para obter uma lista de sinalizadores válidos, consulte DrvPrinterEvent.

lParam

Parâmetro específico do evento fornecido pelo chamador. Para obter mais informações, consulte DrvPrinterEvent.

Valor de retorno

O método deve retornar um dos valores a seguir.

Código de retorno	Descrição
S_OK	A operação foi bem-sucedida.
E_FAIL	Falha na operação.
E_NOTIMPL	O método não é implementado.

Observações

O método IPrintOemUI::PrinterEvent de um plug-in de interface do usuário executa os mesmos tipos de operações que a função DrvPrinterEvent exportada por DLLs da interface da impressora no modo de usuário. Para obter informações sobre eventos de impressora e como eles devem ser processados, consulte a descrição da função DrvPrinterEvent.

Se você fornecer um plug-in de interface do usuário, a função DrvPrinterEvent do driver de impressora chamará o método IPrintOemUI::PrinterEvent. A função DrvPrinterEvent executa seu próprio processamento para o evento especificado e, em seguida, chama o método IPrintOemUI::PrinterEvent para lidar com o processamento adicional do evento.

Se IPrintOemUI::PrinterEvent métodos forem exportados por vários plug-ins de interface do usuário, os métodos serão chamados na ordem em que os plug-ins são especificados para instalação.

Para obter mais informações sobre como criar e instalar plug-ins de interface do usuário, consulte Personalizando os drivers de impressora da Microsoft.

Requisitos

Requisito	Valor
da Plataforma de Destino	Área de trabalho
cabeçalho	prcomoem.h (inclua Prcomoem.h)

Consulte também

DrvPrinterEvent

IPrintOemUI

Partilhar via