Função PartialReplyPrinterChangeNotification (winsplp.h)

  • Artigo

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

Confira também

FindFirstPrinterChangeNotification

ReplyPrinterChangeNotification