Función RouterFreePrinterNotifyInfo (winsplp.h)

Artículo
08/08/2023

La función del administrador de RouterFreePrinterNotifyInfo trabajos de impresión desasigna una estructura de PRINTER_NOTIFY_INFO especificada y su matriz de estructura de PRINTER_NOTIFY_INFO_DATA asociada. (Estas estructuras se describen en la documentación de Microsoft Windows SDK).

Sintaxis

BOOL RouterFreePrinterNotifyInfo(
  [in, optional] PPRINTER_NOTIFY_INFO pInfo
);

Parámetros

[in, optional] pInfo

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

Valor devuelto

Si la operación se realiza correctamente, la función devuelve TRUE. De lo contrario, la función devuelve FALSE.

Comentarios

La función RefreshPrinterChangeNotification de un proveedor de impresión debe llamar RouterFreePrinterNotifyInfo a para desasignar estructuras asignadas previamente por RouterAllocPrinterNotifyInfo, pero solo si RefreshPrinterChangeNotification encuentra un error. Si RefreshPrinterChangeNotification se realiza correctamente, debe suponer que la aplicación cliente desasigna las estructuras.

Además de desasignar la estructura PRINTER_NOTIFY_INFO especificada y su matriz de estructura de PRINTER_NOTIFY_INFO_DATA asociada, la función también desasigna el espacio de búfer al que apunta pBuf en cualquier elemento de la matriz de estructura PRINTER_NOTIFY_INFO_DATA.

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