Função AppendPrinterNotifyInfoData (winsplp.h)
A função AppendPrinterNotifyInfoData do spooler de impressão adiciona o conteúdo de uma estrutura de PRINTER_NOTIFY_INFO_DATA especificada a uma estrutura de PRINTER_NOTIFY_INFO especificada.
Sintaxe
BOOL AppendPrinterNotifyInfoData(
[in] PPRINTER_NOTIFY_INFO pInfoDest,
PPRINTER_NOTIFY_INFO_DATA pDataSrc,
DWORD fdwFlags
);
Parâmetros
[in] pInfoDest
Ponteiro fornecido pelo chamador para uma estrutura PRINTER_NOTIFY_INFO .
pDataSrc
Ponteiro fornecido pelo chamador para uma estrutura de PRINTER_NOTIFY_INFO_DATA .
fdwFlags
Sinalizadores fornecidos pelo chamador. O sinalizador a seguir é definido.
PRINTER_NOTIFY_INFO_DATA_COMPACT
Se definida, a função examinará os membros Tipo, Campo e ID da estrutura de PRINTER_NOTIFY_INFO_DATA fornecida. Se todos corresponderem a um elemento existente da matriz de estrutura PRINTER_NOTIFY_INFO_DATA , o elemento existente será substituído pelo elemento fornecido. Se uma correspondência não for encontrada, a função adicionará a estrutura especificada ao final da matriz.
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
A função RefreshPrinterChangeNotification de um provedor de impressão deve chamar AppendPrinterNotifyInfoData sempre que necessário para preencher uma matriz de estrutura PRINTER_NOTIFY_INFO_DATA , depois de primeiro chamar RouterAllocPrinterNotifyInfo para alocar o armazenamento para a matriz e sua estrutura de PRINTER_NOTIFY_INFO associada.
Com base em se o sinalizador PRINTER_NOTIFY_INFO_DATA_COMPACT está definido, a função acrescenta a estrutura de PRINTER_NOTIFY_INFO_DATA especificada ao final da matriz de estrutura ou substitui um elemento de matriz existente. Se a estrutura for acrescentada, a função incrementará o membro Count da estrutura PRINTER_NOTIFY_INFO.
Se AppendPrinterNotifyInfoData detectar que o sinalizador PRINTER_NOTIFY_INFO_DISCARDED está definido na estrutura de PRINTER_NOTIFY_INFO especificada, a função limpará todas as estruturas PRINTER_NOTIFY_INFO_DATA e definirá o código de erro como ERROR_OUT_OF_STRUCTURES.
Se NULL for especificado para pInfoDataSrc, AppendPrinterNotifyInfoData definirá o sinalizador PRINTER_NOTIFY_INFO_DISCARDED na estrutura de PRINTER_NOTIFY_INFO especificada, limpará todas as estruturas de PRINTER_NOTIFY_INFO_DATA e definirá o código de erro como ERROR_OUT_OF_STRUCTURES.
(Para obter mais informações sobre o sinalizador PRINTER_NOTIFY_INFO_DISCARDED, consulte a descrição de FindNextPrinterChangeNotification na documentação do SDK do Windows.)
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 |