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 prefixados por PRINTER_CHANGE_ fornecidos pelo chamador, listados na descrição da documentação do SDK do Microsoft Windows FindNextPrinterChangeNotification.
[out, optional] pdwResult
Opcional. Se não 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.
Valor de retorno
Se a operação for bem-sucedida, a função retornará VERDADEIRO. Caso contrário, a função retornará FALSE. O chamador pode obter um código de erro chamando GetLastError.
Observações
Os provedores de impressão que não dão suporte à sondagem (consulte FindFirstPrinterChangeNotification) devem notificar o spooler sobre a ocorrência de eventos representados pelos sinalizadores prefixados por PRINTER_CHANGE_ recebidos pela função FindFirstPrinterChangeNotification do provedor. Quando um evento ocorre, 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 fornece 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 do 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 as alterações ocorreram.
Para obter informações adicionais, consulte Suporte a notificações de alteração de impressora.
Requisitos
| Requisito | Valor |
|---|---|
| da Plataforma de Destino | Área de trabalho |
| cabeçalho | winsplp.h (inclua Winsplp.h) |
| biblioteca | Spoolss.lib |
| de DLL | Spoolss.dll |