Función RouterAllocPrinterNotifyInfo (winsplp.h)
La función RouterAllocPrinterNotifyInfo del administrador de impresión asigna una estructura PRINTER_NOTIFY_INFO y una matriz de estructuras de PRINTER_NOTIFY_INFO_DATA. (Estas estructuras se describen en la documentación del SDK de Microsoft Windows).
Sintaxis
PPRINTER_NOTIFY_INFO RouterAllocPrinterNotifyInfo(
DWORD cPrinterNotifyInfoData
);
Parámetros
cPrinterNotifyInfoData
Número proporcionado por el autor de la llamada que especifica el tamaño de la matriz de estructura de PRINTER_NOTIFY_INFO_DATA que se va a asignar.
Valor devuelto
La función devuelve un puntero a la estructura de PRINTER_NOTIFY_INFO asignada.
Observaciones
Los proveedores de impresión deben llamar a RouterAllocPrinterNotifyInfo para asignar la estructura PRINTER_NOTIFY_INFO y la matriz de estructura PRINTER_NOTIFY_INFO_DATA que debe proporcionar la función de RefreshPrinterChangeNotification del proveedor.
La función RouterAllocPrinterNotifyInfo inicializa el miembro Version de PRINTER_NOTIFY_INFO de la estructura a la versión actual de la implementación de notificaciones del administrador de colas. Inicializa el de marcas de de la estructura y miembros Count en cero, independientemente del número especificado para cPrinterNotifyInfoData.
Los proveedores de impresión deben llamar a AppendPrinterNotifyInfoData para rellenar los miembros de la matriz de estructura de PRINTER_NOTIFY_INFO_DATA.
Si RefreshPrinterChangeNotification se ejecuta correctamente y devuelve las estructuras asignadas al autor de la llamada, debe suponer que el autor de la llamada desasignará la memoria de la estructura. Sin embargo, si RefreshPrinterChangeNotification encuentra un error, debe llamar a RouterFreePrinterNotifyInfo para desasignar la memoria.
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 |