Función RouterAllocPrinterNotifyInfo (winsplp.h)
La función del RouterAllocPrinterNotifyInfo administrador de trabajos de impresión asigna una estructura de PRINTER_NOTIFY_INFO y una matriz de estructuras de PRINTER_NOTIFY_INFO_DATA. (Estas estructuras se describen en la documentación de Microsoft Windows SDK).
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.
Comentarios
Los proveedores de impresión deben llamar RouterAllocPrinterNotifyInfo a para asignar la estructura de PRINTER_NOTIFY_INFO y la matriz de estructura de PRINTER_NOTIFY_INFO_DATA que debe proporcionar la función RefreshPrinterChangeNotification del proveedor.
La RouterAllocPrinterNotifyInfo función inicializa el miembro Version de la estructura PRINTER_NOTIFY_INFO a la versión actual de la implementación de notificación del administrador de colas. Inicializa los miembros Flags y Count de la estructura 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 desasigna 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 | Value |
|---|---|
| Plataforma de destino | Escritorio |
| Encabezado | winsplp.h (incluya Winsplp.h) |
| Library | Spoolss.lib |
| Archivo DLL | Spoolss.dll |