PartialReplyPrinterChangeNotification-Funktion (winsplp.h)

Die PartialReplyPrinterChangeNotification-Funktion des Druckspoolers ermöglicht es einem Druckanbieter, die Datenbank des Spoolers mit Druckeränderungen zu aktualisieren, die einem Benachrichtigungshandle zugeordnet sind.

Syntax

BOOL PartialReplyPrinterChangeNotification(
  HANDLE                    hPrinter,
  PPRINTER_NOTIFY_INFO_DATA pDataSrc
);

Parameter

hPrinter

Vom Aufrufer bereitgestelltes Handle. Dieses Handle muss zuvor als hNotify-Eingabe für die FindFirstPrinterChangeNotification-Funktion des Druckanbieters empfangen worden sein.

pDataSrc

Vom Aufrufer bereitgestellter Zeiger auf eine PRINTER_NOTIFY_INFO_DATA-Struktur (beschrieben in der Microsoft Windows SDK-Dokumentation). Kann NULL sein. Weitere Informationen finden Sie im folgenden Abschnitt "Hinweise".

Rückgabewert

Wenn der Vorgang erfolgreich ist, gibt die Funktion TRUE zurück. Andernfalls gibt die Funktion FALSE zurück. Der Aufrufer kann einen Fehlercode abrufen, indem er GetLastError aufruft.

Hinweise

Für das angegebene Benachrichtigungshandle fügt die PartialReplyPrinterChangeNotification-Funktion des Spoolers den Inhalt der angegebenen PRINTER_NOTIFY_INFO_DATA-Struktur dem Array innerhalb der gespeicherten PRINTER_NOTIFY_INFO-Struktur des Spoolers hinzu. (Diese Strukturen werden in der Windows SDK-Dokumentation beschrieben.)

Das Aufrufen von PartialReplyPrinterChangeNotification bewirkt nicht, dass der Spooler die Anwendung benachrichtigt, dass Änderungen aufgetreten sind. Wenn die FindFirstPrinterChangeNotification-Funktion des Druckanbieters das PRINTER_NOTIFY_STATUS_POLL-Flag nicht festgelegt hat, muss der Anbieter ReplyPrinterChangeNotification aufrufen, damit die Anwendung benachrichtigt wird.

Wenn pInfoDataSrcNULL ist, werden alle gespeicherten Informationen, die dem angegebenen Handle zugeordnet sind, aus dem Spooler gelöscht. Die Funktion führt diese Löschung durch, indem alle Puffer freigegeben werden, die pBuf-Membern von PRINTER_NOTIFY_INFO_DATA Strukturen zugeordnet sind, die zum angegebenen Handle gehören. Anschließend legt die Funktion das PRINTER_NOTIFY_INFO_DISCARDED-Flag in der gespeicherten PRINTER_NOTIFY_INFO-Struktur fest.

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

Anforderungen

Weitere Informationen

FindFirstPrinterChangeNotification

ReplyPrinterChangeNotification