Función ReplyPrinterChangeNotification (winsplp.h)
La función ReplyPrinterChangeNotification del administrador de impresión permite a un proveedor de impresión actualizar la base de datos del cola de impresión de eventos de cola de impresión asociados a un identificador de notificación y notificar al cliente que se han producido eventos de cola de impresión.
Sintaxis
BOOL ReplyPrinterChangeNotification(
HANDLE hPrinter,
DWORD fdwChangeFlags,
[out, optional] PDWORD pdwResult,
[in, optional] PVOID pPrinterNotifyInfo
);
Parámetros
hPrinter
Identificador proporcionado por el autor de la llamada. Este identificador debe haberse recibido previamente como la entrada hNotify a la función FindFirstPrinterChangeNot ification del proveedor de impresión.
fdwChangeFlags
Una o varias marcas proporcionadas por el autor de la llamada PRINTER_CHANGE_ con prefijo, enumeradas en la descripción de la documentación del SDK de Microsoft Windows de FindNextPrinterChangeNotification.
[out, optional] pdwResult
Opcional. Si no NULL, recibe marcas PRINTER_NOTIFY_INFO con prefijo proporcionadas por spooler que indican los resultados de la actualización de la información proporcionada.
[in, optional] pPrinterNotifyInfo
Opcional. Dirección proporcionada por el autor de la llamada de una estructura de PRINTER_NOTIFY_INFO (que se describe en la documentación de Windows SDK). Puede ser NULL si no se agrega información de notificación nueva.
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
Los proveedores de impresión que no admiten el sondeo (consulte FindFirstPrinterChangeNotification) deben notificar al administrador de colas la aparición de cualquier evento representado por las marcas con prefijo PRINTER_CHANGE_ recibidas por la función FindFirstPrinterChangeNotification del proveedor. Cuando se produce un evento, el proveedor de impresión puede llamar a ReplyPrinterChangeNotification para informar al administrador del evento y proporcionar información asociada al evento. El administrador de colas realiza un seguimiento de esta información de eventos, para cada identificador de notificación y entrega la información a una aplicación cuando la aplicación llama a FindNextPrinterChangeNotification (que se describe en la documentación de Windows SDK).
Cuando un proveedor de impresión llama a ReplyPrinterChangeNotification, debe identificar el evento que se ha producido estableciendo una marca con prefijo PRINTER_CHANGE_ en fwdFlags o mediante pPrinterNotifyInfo para devolver una estructura de PRINTER_NOTIFY_INFO. (Use las marcas enumeradas en la descripción de la documentación de Windows SDK de FindNextPrinterChangeNotification,no las marcas enumeradas en la descripción de la documentación de Windows SDK de FindFirstPrinterChangeNotification).
Llamar a ReplyPrinterChangeNotification hace que el colador indique a la aplicación cliente que se ha producido un evento de cola de impresión. Esto sucede incluso si el proveedor proporciona NULL para pPrinterNotifyInfo. Para actualizar el registro de la cola de impresión de los cambios de la cola de impresión sin que se notifique al cliente, use PartialReplyPrinterChangeNotification. Es habitual llamar a PartialReplyPrinterChangeNotification varias veces actualizar la base de datos del administrador de colas y, a continuación, llamar a ReplyPrinterChangeNotification para notificar al cliente que se han producido cambios.
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 |