Função FindFirstPrinterChangeNotification (winspool.h)

Artigo
03/01/2024

Aviso

A partir do Windows 10, as APIs que dão suporte a provedores de impressão de terceiros foram preteridas. A Microsoft não recomenda nenhum investimento em provedores de impressão de terceiros. Além disso, em Windows 8 e produtos mais recentes em que o modelo de driver de impressão v4 está disponível, os provedores de impressão de terceiros podem não criar ou gerenciar filas que usam drivers de impressão v4.

A função FindFirstPrinterChangeNotification de um provedor de impressão informa ao provedor que um aplicativo solicitou notificação quando um conjunto especificado de eventos ocorre em uma fila de impressão especificada.

Sintaxe

HANDLE FindFirstPrinterChangeNotification(
  HANDLE hPrinter,
  DWORD  fdwFilter,
  DWORD  fdwOptions,
  PVOID  pPrinterNotifyOptions
);

Parâmetros

hPrinter

Identificador de impressora fornecido pelo chamador, identificando a impressora para a qual a notificação de evento está sendo solicitada. Esse identificador deve ter sido obtido anteriormente do OpenPrinter.

fdwFilter

Define o parâmetro DWORDfdwFilter.

fdwOptions

Não usado.

pPrinterNotifyOptions

Ponteiro fornecido pelo chamador para uma estrutura de PRINTER_NOTIFY_OPTIONS (descrito na documentação do SDK do Windows).

Retornar valor

Retorna o identificador do driver de impressão.

Comentários

Quando o spooler chama a função FindFirstPrinterChangeNotification de um provedor de impressão, pPrinterNotifyOptions identifica os tipos de informações que o provedor de impressão deve enviar ao spooler quando ocorre um dos eventos especificados.

Para obter uma lista dos tipos de notificações que um aplicativo pode solicitar e para obter uma lista dos tipos de informações que podem ser usados para descrever um evento, consulte a descrição da documentação do SDK do Windows de FindFirstPrinterChangeNotification. Os tipos de eventos para os quais um aplicativo pode solicitar notificação incluem adicionar ou excluir um trabalho ou formulário de impressão. Os tipos de informações que um aplicativo pode solicitar incluem parâmetros de trabalho ou formulário.

Se o provedor de impressão não solicitar sondagem, o provedor de impressão deverá fornecer os tipos de informações identificadas por pPrinterNotifyOptions, chamando PartialReplyPrinterChangeNotification ou ReplyPrinterChangeNotification.

Se o provedor solicitar sondagem (ou seja, definir PRINTER_NOTIFY_STATUS_POLL), ele não deverá chamar ReplyPrinterChangeNotification. Em vez disso, o spooler sinaliza o aplicativo em intervalos regulares.

O provedor de impressão sondado e nãopolado deve retornar o estado atual de todos os tipos de informações solicitados sempre que sua função RefreshPrinterChangeNotification for chamada.

Para obter informações adicionais, consulte Suporte a notificações de alteração de impressora.