Função PartialReplyPrinterChangeNotification (winsplp.h)
A função PartialReplyPrinterChangeNotification do spooler de impressão permite que um provedor de impressão atualize o banco de dados do spooler de alterações de impressora associadas a um identificador de notificação.
Sintaxe
BOOL PartialReplyPrinterChangeNotification(
HANDLE hPrinter,
PPRINTER_NOTIFY_INFO_DATA pDataSrc
);
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.
pDataSrc
Ponteiro fornecido pelo chamador para uma estrutura de PRINTER_NOTIFY_INFO_DATA (descrito na documentação do SDK do Microsoft Windows). Pode ser NULL. Para obter mais informações, consulte a seção Comentários a seguir.
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
Para o identificador de notificação especificado, a função PartialReplyPrinterChangeNotification do spooler adiciona o conteúdo da estrutura de PRINTER_NOTIFY_INFO_DATA especificada à matriz dentro da estrutura de PRINTER_NOTIFY_INFO armazenada do spooler. (Essas estruturas são descritas na documentação do SDK do Windows.)
Chamar PartialReplyPrinterChangeNotification não faz com que o spooler notifique o aplicativo de que ocorreram alterações. Se a função FindFirstPrinterChangeNotification do provedor de impressão não tiver definido o sinalizador PRINTER_NOTIFY_STATUS_POLL, o provedor deverá chamar ReplyPrinterChangeNotification para fazer com que o aplicativo seja notificado.
Se pInfoDataSrc for NULL, todas as informações armazenadas associadas ao identificador especificado serão excluídas do spooler. A função realiza essa exclusão liberando todos os buffers associados aos membros do pBuf de PRINTER_NOTIFY_INFO_DATA estruturas pertencentes ao identificador especificado. Em seguida, a função define o sinalizador PRINTER_NOTIFY_INFO_DISCARDED na estrutura de PRINTER_NOTIFY_INFO armazenada.
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 |