Função RouterFreePrinterNotifyInfo (winsplp.h)

A função do spooler de RouterFreePrinterNotifyInfo impressão desaloca uma estrutura de PRINTER_NOTIFY_INFO especificada e sua matriz de estrutura PRINTER_NOTIFY_INFO_DATA associada. (Essas estruturas são descritas na documentação do SDK do Microsoft Windows.)

Sintaxe

BOOL RouterFreePrinterNotifyInfo(
  [in, optional] PPRINTER_NOTIFY_INFO pInfo
);

Parâmetros

[in, optional] pInfo

Ponteiro fornecido pelo chamador para uma estrutura de PRINTER_NOTIFY_INFO (descrito na documentação do SDK do Windows).

Retornar valor

Se a operação for bem-sucedida, a função retornará TRUE. Caso contrário, a função retornará FALSE.

Comentários

A função RefreshPrinterChangeNotification de um provedor de impressão deve chamar RouterFreePrinterNotifyInfo para desalocar estruturas alocadas anteriormente por RouterAllocPrinterNotifyInfo, mas somente se RefreshPrinterChangeNotification encontrar um erro. Se RefreshPrinterChangeNotification for bem-sucedido, você deverá assumir que o aplicativo cliente desalocará as estruturas.

Além de desalocar a estrutura de PRINTER_NOTIFY_INFO especificada e sua matriz de estrutura PRINTER_NOTIFY_INFO_DATA associada, a função também desaloca o espaço de buffer apontado por pBuf em qualquer elemento da matriz de estrutura PRINTER_NOTIFY_INFO_DATA.

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

RefreshPrinterChangeNotification

RouterAllocPrinterNotifyInfo