Suporte a notificações de alteração de impressora

Os aplicativos podem solicitar a notificação das ocorrências de eventos de fila de impressão chamando as funções do spooler FindFirstPrinterChangeNotification, FindNextPrinterChangeNotification e FindClosePrinterChangeNotification. Se você acha que os desenvolvedores de aplicativos desejarão solicitar notificação de evento para filas de impressão suportadas pelo seu provedor de impressão parcial, você deve dar suporte à notificação de evento em seu provedor da seguinte maneira:

• Forneça uma função FindFirstPrinterChangeNotification .

  O spooler chama essa função para fornecer ao provedor de impressão as seguintes informações:

  • Um conjunto de sinalizadores que indica os tipos de eventos de impressora para os quais o aplicativo solicitou a notificação.

  • Um identificador para a fila de impressão para a qual as notificações estão sendo solicitadas.

  • Uma lista de tipos de informações que o aplicativo solicitou para ser fornecida quando um evento ocorre.

    A função deve retornar um valor de sinalizador que indica se o provedor deve ser sondado para determinar se houve alterações. Provedores não sondados enviam sinais ao cliente sempre que ocorrem alterações. Um provedor que deve ser sondado não envia sinais para um cliente quando ocorrem alterações. Em vez disso, o spooler sinaliza o cliente em intervalos regulares, independentemente de as alterações terem ocorrido ou não.

    No nível do provedor, essa função tem argumentos diferentes do que no nível do Win32.

• Acompanhe todos os eventos de fila de impressão especificados pelo aplicativo quando ele chamou FindFirstPrinterChangeNotification.

  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 função Win32 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. Tipos de informações que um aplicativo pode solicitar incluem parâmetros de trabalho ou formulário.

  Os provedores de impressão que não são sondados devem chamar PartialReplyPrinterChangeNotification ou ReplyPrinterChangeNotification quando ocorrerem alterações, para fornecer ao spooler informações que descrevem as alterações. A função ReplyPrinterChangeNotification deve ser chamada em algum momento porque faz com que o spooler sinalize o aplicativo, enquanto a função PartialReplyPrinterChangeNotification não. Quando o aplicativo recebe um sinal de ReplyPrinterChangeNotification, ele deve chamar FindNextPrinterChangeNotification. Esta última função fornece ao aplicativo as informações de evento que o spooler recebeu anteriormente do provedor de impressão.

  Os provedores de impressão que são sondados devem simplesmente acompanhar as alterações. O spooler sinaliza o aplicativo em intervalos regulares. Quando o aplicativo recebe um sinal, ele deve chamar a função FindNextPrinterChangeNotification do spooler. Para provedores sondados, essa função chama a função RefreshPrinterChangeNotification do provedor.

• Forneça uma função RefreshPrinterChangeNotification .

  Essa função deve retornar o estado atual de todas as opções de fila de impressão monitoradas para a fila de impressão especificada. O spooler chama essa função quando um aplicativo chama FindNextPrinterChangeNotification com o flag PRINTER_NOTIFY_OPTIONS_REFRESH definido.

  Os aplicativos devem definir esse sinalizador se uma chamada anterior para FindNextPrinterChangeNotification retornar uma estrutura PRINTER_NOTIFY_INFO com o sinalizador PRINTER_NOTIFY_INFO_DISCARDED definido. Provedores com pesquisa e sem pesquisa devem dar suporte a RefreshPrinterChangeNotification.

• Forneça uma função FindClosePrinterChangeNotification .