Função RouterAllocPrinterNotifyInfo (winsplp.h)
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.
Requisitos
| Requisito | Valor |
|---|---|
| Plataforma de Destino | Área de Trabalho |
| Cabeçalho | winsplp.h (inclua Winsplp.h) |
| Biblioteca | Spoolss.lib |
| DLL | Spoolss.dll |