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
| Anforderung | Wert |
|---|---|
| Zielplattform | Desktop |
| Kopfzeile | winsplp.h (winsplp.h einschließen) |
| Bibliothek | Spoolss.lib |
| DLL | Spoolss.dll |