RouterAllocPrinterNotifyInfo-Funktion (winsplp.h)

Artikel
02/27/2024

Die Funktion des RouterAllocPrinterNotifyInfo Druckspoolers ordnet eine PRINTER_NOTIFY_INFO-Struktur und ein Array von PRINTER_NOTIFY_INFO_DATA-Strukturen zu. (Diese Strukturen werden in der Microsoft Windows SDK-Dokumentation beschrieben.)

Syntax

PPRINTER_NOTIFY_INFO RouterAllocPrinterNotifyInfo(
  DWORD cPrinterNotifyInfoData
);

Parameter

cPrinterNotifyInfoData

Vom Aufrufer bereitgestellte Zahl, die die Größe des PRINTER_NOTIFY_INFO_DATA zuzuordnenden Strukturarrays angibt.

Rückgabewert

Die Funktion gibt einen Zeiger auf die zugeordnete PRINTER_NOTIFY_INFO-Struktur zurück.

Hinweise

Druckanbieter sollten aufrufen RouterAllocPrinterNotifyInfo , um die PRINTER_NOTIFY_INFO-Struktur und das PRINTER_NOTIFY_INFO_DATA-Strukturarray zuzuordnen, das von der RefreshPrinterChangeNotification-Funktion des Anbieters bereitgestellt werden muss.

Die RouterAllocPrinterNotifyInfo Funktion initialisiert den Versionsmember der PRINTER_NOTIFY_INFO-Struktur mit der aktuellen Version der Benachrichtigungsimplementierung des Spoolers. Die Flags und Count-Member der Struktur werden unabhängig von der für cPrinterNotifyInfoData angegebenen Zahl auf 0 (null) initialisiert.

Druckanbieter sollten AppendPrinterNotifyInfoData aufrufen, um Member des PRINTER_NOTIFY_INFO_DATA-Strukturarrays auszufüllen.

Wenn RefreshPrinterChangeNotification erfolgreich ausgeführt wird und die zugeordneten Strukturen an den Aufrufer zurückgegeben werden, sollten Sie davon ausgehen, dass der Aufrufer die Zuordnung des Strukturspeichers aufgibt. Wenn RefreshPrinterChangeNotification jedoch ein Fehler auftritt, sollte RouterFreePrinterNotifyInfo aufgerufen werden, um die Zuordnung des Arbeitsspeichers aufzugeben.

Weitere Informationen finden Sie unter Unterstützen von Druckeränderungsbenachrichtigungen.