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 se debe haber recibido previamente como entrada hNotify en la función FindFirstPrinterChangeNotification del proveedor de impresión.
fdwChangeFlags
Una o varias marcas PRINTER_CHANGE_ prefijo proporcionadas por el autor de la llamada, enumeradas en la descripción de la documentación de Microsoft Windows SDK de FindNextPrinterChangeNotification.
[out, optional] pdwResult
Opcional. Si no es NULL, recibe marcas PRINTER_NOTIFY_INFO 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 (descrita en la documentación de Windows SDK). Puede ser NULL si no se agrega ninguna nueva información de notificación.
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.
Comentarios
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 (descrita 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 administrador de colas 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 para 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 | Value |
|---|---|
| Plataforma de destino | Escritorio |
| Encabezado | winsplp.h (incluya Winsplp.h) |
| Library | Spoolss.lib |
| Archivo DLL | Spoolss.dll |