Función PartialReplyPrinterChangeNotification (winsplp.h)

La función PartialReplyPrinterChangeNotification del administrador de impresión permite a un proveedor de impresión actualizar la base de datos de la impresora de los cambios de impresora asociados a un identificador de notificación.

Sintaxis

BOOL PartialReplyPrinterChangeNotification(
  HANDLE                    hPrinter,
  PPRINTER_NOTIFY_INFO_DATA pDataSrc
);

Parámetros

hPrinter

Identificador proporcionado por el autor de la llamada. Este identificador debe haberse recibido previamente como entrada hNotify en la función FindFirstPrinterChangeNotification del proveedor de impresión.

pDataSrc

Puntero proporcionado por el autor de la llamada a una estructura de PRINTER_NOTIFY_INFO_DATA (descrita en la documentación de Microsoft Windows SDK). Puede ser NULL. Para obtener más información, vea la sección Comentarios que se muestra más adelante.

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

Para el identificador de notificación especificado, la función PartialReplyPrinterChangeNotification del administrador de colas agrega el contenido de la estructura de PRINTER_NOTIFY_INFO_DATA especificada a la matriz dentro de la estructura almacenada PRINTER_NOTIFY_INFO del administrador de colas. (Estas estructuras se describen en la documentación de Windows SDK).

Llamar a PartialReplyPrinterChangeNotification no hace que el administrador de cola notifique a la aplicación que se han producido cambios. Si la función FindFirstPrinterChangeNotification del proveedor de impresión no estableció la marca de PRINTER_NOTIFY_STATUS_POLL, el proveedor debe llamar a ReplyPrinterChangeNotification para que se notifique a la aplicación.

Si pInfoDataSrc es NULL, toda la información almacenada asociada al identificador especificado se elimina del colador. La función realiza esta eliminación liberando todos los búferes asociados a miembros pBuf de PRINTER_NOTIFY_INFO_DATA estructuras pertenecientes al identificador especificado. A continuación, la función establece la marca PRINTER_NOTIFY_INFO_DISCARDED en la estructura de PRINTER_NOTIFY_INFO almacenada.

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

Consulte también

FindFirstPrinterChangeNotification

ReplyPrinterChangeNotification