Função RouterAllocPrinterNotifyInfo (winsplp.h)

Artigo
03/01/2024

A função do spooler de RouterAllocPrinterNotifyInfo impressão aloca uma estrutura PRINTER_NOTIFY_INFO e uma matriz de estruturas de PRINTER_NOTIFY_INFO_DATA. (Essas estruturas são descritas na documentação do SDK do Microsoft Windows.)

Sintaxe

PPRINTER_NOTIFY_INFO RouterAllocPrinterNotifyInfo(
  DWORD cPrinterNotifyInfoData
);

Parâmetros

cPrinterNotifyInfoData

Número fornecido pelo chamador especificando o tamanho da matriz de estrutura PRINTER_NOTIFY_INFO_DATA a ser alocada.

Retornar valor

A função retorna um ponteiro para a estrutura de PRINTER_NOTIFY_INFO alocada.

Comentários

Os provedores de impressão devem chamar RouterAllocPrinterNotifyInfo para alocar a estrutura PRINTER_NOTIFY_INFO e a matriz de estrutura PRINTER_NOTIFY_INFO_DATA que a função RefreshPrinterChangeNotification do provedor deve fornecer.

A RouterAllocPrinterNotifyInfo função inicializa o membro Version da estrutura PRINTER_NOTIFY_INFO para a versão atual da implementação de notificação do spooler. Ele inicializa os membros Flags e Count da estrutura como zero, independentemente do número especificado para cPrinterNotifyInfoData.

Os provedores de impressão devem chamar AppendPrinterNotifyInfoData para preencher membros da matriz de estrutura PRINTER_NOTIFY_INFO_DATA.

Se RefreshPrinterChangeNotification for executado com êxito e retornar as estruturas alocadas para o chamador, você deverá assumir que o chamador desalocará a memória da estrutura. No entanto, se RefreshPrinterChangeNotification encontrar um erro, ele deverá chamar RouterFreePrinterNotifyInfo para desalocar a memória.

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