Função RouterAllocPrinterNotifyInfo (winsplp.h)
A função RouterAllocPrinterNotifyInfo do spooler de impressão aloca uma estrutura PRINTER_NOTIFY_INFO e uma matriz de estruturas 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.
Valor de retorno
A função retorna um ponteiro para a estrutura de PRINTER_NOTIFY_INFO alocada.
Observações
Os provedores de impressão devem chamar RouterAllocPrinterNotifyInfo para alocar a estrutura de PRINTER_NOTIFY_INFO e a matriz de estrutura PRINTER_NOTIFY_INFO_DATA que a função RefreshPrinterChangeNotification do provedor deve fornecer.
A função RouterAllocPrinterNotifyInfo 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 sinalizadores da estrutura e contar membros 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 ao 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 |
|---|---|
| da Plataforma de Destino | Área de trabalho |
| cabeçalho | winsplp.h (inclua Winsplp.h) |
| biblioteca | Spoolss.lib |
| de DLL | Spoolss.dll |