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 |