Função AppendPrinterNotifyInfoData (winsplp.h)
A função AppendPrinterNotifyInfoData do 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 de 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 Type, Fielde Id membros da estrutura de PRINTER_NOTIFY_INFO_DATA fornecida. Se todos eles corresponderem a um elemento existente da matriz de estrutura PRINTER_NOTIFY_INFO_DATA, o elemento existente será substituído com o elemento fornecido. Se uma correspondência não for encontrada, a função adicionará a estrutura especificada ao final da matriz.
Valor de retorno
Se a operação for bem-sucedida, a função retornará VERDADEIRO. Caso contrário, a função retornará FALSE. O chamador pode obter um código de erro chamando GetLastError.
Observações
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 chamar primeiro 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 PRINTER_NOTIFY_INFO_DATA especificada ao final da matriz da estrutura ou substitui um elemento de matriz existente. Se a estrutura for acrescentada, a função incrementará o membro de contagem de da estrutura PRINTER_NOTIFY_INFO.
Se AppendPrinterNotifyInfoData detectar que o sinalizador de PRINTER_NOTIFY_INFO_DISCARDED está definido na estrutura de PRINTER_NOTIFY_INFO especificada, a função limpará todas as estruturas de 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 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 |
|---|---|
| da Plataforma de Destino | Área de trabalho |
| cabeçalho | winsplp.h (inclua Winsplp.h) |
| biblioteca | Spoolss.lib |
| de DLL | Spoolss.dll |