Función FindFirstPrinterChangeNotification (winspool.h)

Artículo
02/27/2024

Advertencia

A partir de Windows 10, las API que admiten proveedores de impresión de terceros están en desuso. Microsoft no recomienda ninguna inversión en proveedores de impresión de terceros. Además, en Windows 8 y productos más recientes en los que el modelo de controlador de impresión v4 está disponible, es posible que los proveedores de impresión de terceros no creen ni administren colas que usen controladores de impresión v4.

La función FindFirstPrinterChangeNotification de un proveedor de impresión informa al proveedor de que una aplicación ha solicitado una notificación cuando se produce un conjunto especificado de eventos en una cola de impresión especificada.

Sintaxis

HANDLE FindFirstPrinterChangeNotification(
  HANDLE hPrinter,
  DWORD  fdwFilter,
  DWORD  fdwOptions,
  PVOID  pPrinterNotifyOptions
);

Parámetros

hPrinter

Identificador de impresora proporcionado por el autor de la llamada, que identifica la impresora para la que se solicita la notificación de eventos. Este identificador debe haberse obtenido previamente de OpenPrinter.

fdwFilter

Define el parámetro DWORDfdwFilter.

fdwOptions

No se usa.

pPrinterNotifyOptions

Puntero proporcionado por el autor de la llamada a una estructura de PRINTER_NOTIFY_OPTIONS (que se describe en la documentación de Windows SDK).

Valor devuelto

Devuelve el identificador del controlador de impresión.

Comentarios

Cuando el administrador de trabajos de impresión llama a la función FindFirstPrinterChangeNotification de un proveedor de impresión, pPrinterNotifyOptions identifica los tipos de información que el proveedor de impresión debe enviar al administrador de trabajos de impresión cuando se produce uno de los eventos especificados.

Para obtener una lista de los tipos de notificaciones que una aplicación puede solicitar y para obtener una lista de los tipos de información que se pueden usar para describir un evento, consulte la descripción de la documentación de Windows SDK de FindFirstPrinterChangeNotification. Los tipos de eventos para los que una aplicación podría solicitar una notificación incluyen agregar o eliminar un trabajo o formulario de impresión. Los tipos de información que una aplicación puede solicitar incluyen parámetros de trabajo o formulario.

Si el proveedor de impresión no solicita sondeos, el proveedor de impresión debe proporcionar los tipos de información identificados por pPrinterNotifyOptions mediante una llamada a PartialReplyPrinterChangeNotification o ReplyPrinterChangeNotification.

Si el proveedor solicita sondeo (es decir, establece PRINTER_NOTIFY_STATUS_POLL), no debe llamar a ReplyPrinterChangeNotification. En su lugar, el administrador de colas indica a la aplicación a intervalos regulares.

Tanto el proveedor de impresión sondeado como el nopoldo deben devolver el estado actual de todos los tipos de información solicitados cada vez que se llama a su función RefreshPrinterChangeNotification .

Para obtener más información, consulte Compatibilidad con las notificaciones de cambio de impresora.