Función AppendPrinterNotifyInfoData (winsplp.h)
La función AppendPrinterNotifyInfoData del administrador de impresión agrega el contenido de una estructura de PRINTER_NOTIFY_INFO_DATA especificada a una estructura PRINTER_NOTIFY_INFO especificada.
Sintaxis
BOOL AppendPrinterNotifyInfoData(
[in] PPRINTER_NOTIFY_INFO pInfoDest,
PPRINTER_NOTIFY_INFO_DATA pDataSrc,
DWORD fdwFlags
);
Parámetros
[in] pInfoDest
Puntero proporcionado por el autor de la llamada a una estructura PRINTER_NOTIFY_INFO.
pDataSrc
Puntero proporcionado por el autor de la llamada a una estructura PRINTER_NOTIFY_INFO_DATA.
fdwFlags
Marcas proporcionadas por el autor de la llamada. Se define la marca siguiente.
PRINTER_NOTIFY_INFO_DATA_COMPACT
Si se establece, la función examina los miembros Type, Fieldy Id. de la estructura de PRINTER_NOTIFY_INFO_DATA proporcionada. Si todos coinciden con un elemento existente de la matriz de estructura de PRINTER_NOTIFY_INFO_DATA, el elemento existente se sobrescribe con el elemento proporcionado. Si no se encuentra una coincidencia, la función agrega la estructura especificada al final de la matriz.
Valor devuelto
Si la operación se realiza correctamente, la función devuelve TRUE. De lo contrario, la función devuelve FALSE. El autor de la llamada puede obtener un código de error llamando a GetLastError.
Observaciones
La función RefreshPrinterChangeNotification de un proveedor de impresión debe llamar a AppendPrinterNotifyInfoData tantas veces como sea necesario para rellenar una matriz de estructura de PRINTER_NOTIFY_INFO_DATA, después de llamar primero a RouterAllocPrinterNotifyInfo asignar almacenamiento para la matriz y su estructura de PRINTER_NOTIFY_INFO asociada.
En función de si se establece la marca PRINTER_NOTIFY_INFO_DATA_COMPACT, la función anexa la estructura de PRINTER_NOTIFY_INFO_DATA especificada al final de la matriz de estructura o sobrescribe un elemento de matriz existente. Si se anexa la estructura, la función incrementa el miembro Count de la estructura de PRINTER_NOTIFY_INFO.
Si AppendPrinterNotifyInfoData detecta que la marca PRINTER_NOTIFY_INFO_DISCARDED está establecida en la estructura de PRINTER_NOTIFY_INFO especificada, la función borra todas las estructuras de PRINTER_NOTIFY_INFO_DATA y establece el código de error en ERROR_OUT_OF_STRUCTURES.
Si se especifica NULL para pInfoDataSrc, AppendPrinterNotifyInfoData establece la marca PRINTER_NOTIFY_INFO_DISCARDED en la estructura de PRINTER_NOTIFY_INFO especificada, borra todas las estructuras de PRINTER_NOTIFY_INFO_DATA y establece el código de error en ERROR_OUT_OF_STRUCTURES.
(Para obtener más información sobre la marca de PRINTER_NOTIFY_INFO_DISCARDED, consulte la descripción de FindNextPrinterChangeNotification en la documentación de Windows SDK).
Para obtener más información, consulte compatibilidad con las notificaciones de cambio de impresora.
Requisitos
| Requisito | Valor |
|---|---|
| de la plataforma de destino de | Escritorio |
| encabezado de | winsplp.h (incluya Winsplp.h) |
| biblioteca de | Spoolss.lib |
| DLL de | Spoolss.dll |