Função ReplyPrinterChangeNotification (winsplp.h)

A função ReplyPrinterChangeNotification do spooler de impressão permite que um provedor de impressão atualize o banco de dados do spooler de eventos de fila de impressão associados a um identificador de notificação e notifique o cliente de que eventos de fila de impressão ocorreram.

Sintaxe

BOOL ReplyPrinterChangeNotification(
                  HANDLE hPrinter,
                  DWORD  fdwChangeFlags,
  [out, optional] PDWORD pdwResult,
  [in, optional]  PVOID  pPrinterNotifyInfo
);

Parâmetros

hPrinter

Identificador fornecido pelo chamador. Esse identificador deve ter sido recebido anteriormente como a entrada hNotify para a função FindFirstPrinterChangeNotification do provedor de impressão.

fdwChangeFlags

Um ou mais sinalizadores com prefixo PRINTER_CHANGE_ fornecidos pelo chamador, listados na descrição da documentação do SDK do Microsoft Windows de FindNextPrinterChangeNotification.

[out, optional] pdwResult

Opcional. Se não for NULL, ele receberá sinalizadores com prefixo PRINTER_NOTIFY_INFO fornecidos pelo spooler indicando os resultados da atualização das informações fornecidas.

[in, optional] pPrinterNotifyInfo

Opcional. Endereço fornecido pelo chamador de uma estrutura de PRINTER_NOTIFY_INFO (descrito na documentação do SDK do Windows). Pode ser NULL se nenhuma nova informação de notificação estiver sendo adicionada.

Retornar valor

Se a operação for bem-sucedida, a função retornará TRUE. Caso contrário, a função retornará FALSE. O chamador pode obter um código de erro chamando GetLastError.

Comentários

Os provedores de impressão que não dão suporte à sondagem (consulte FindFirstPrinterChangeNotification) devem notificar o spooler da ocorrência de eventos representados pelos sinalizadores prefixados por PRINTER_CHANGE_ recebidos pela função FindFirstPrinterChangeNotification do provedor. Quando ocorre um evento, o provedor de impressão pode chamar ReplyPrinterChangeNotification para informar o spooler do evento e fornecer informações associadas ao evento. O spooler controla essas informações de evento, para cada identificador de notificação, e entrega as informações a um aplicativo quando o aplicativo chama FindNextPrinterChangeNotification (descrito na documentação do SDK do Windows).

Quando um provedor de impressão chama ReplyPrinterChangeNotification, ele deve identificar o evento que ocorreu definindo um sinalizador prefixado por PRINTER_CHANGE_ em fwdFlags ou usando pPrinterNotifyInfo para retornar uma estrutura PRINTER_NOTIFY_INFO. (Use os sinalizadores listados na descrição da documentação do SDK do Windows de FindNextPrinterChangeNotification, não os sinalizadores listados na descrição da documentação SDK do Windows de FindFirstPrinterChangeNotification.)

Chamar ReplyPrinterChangeNotification faz com que o spooler sinalize ao aplicativo cliente que ocorreu um evento de fila de impressão. Isso acontece mesmo que o provedor forneça NULL para pPrinterNotifyInfo. Para atualizar o registro do spooler de alterações na fila de impressão sem fazer com que o cliente seja notificado, use PartialReplyPrinterChangeNotification. É comum chamar PartialReplyPrinterChangeNotification várias vezes para atualizar o banco de dados do spooler e, em seguida, chamar ReplyPrinterChangeNotification para notificar o cliente de que ocorreram alterações.

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

Requisitos

Requisito	Valor
Plataforma de Destino	Área de Trabalho
Cabeçalho	winsplp.h (inclua Winsplp.h)
Biblioteca	Spoolss.lib
DLL	Spoolss.dll

Confira também

FindFirstPrinterChangeNotification

PartialReplyPrinterChangeNotification