PartialReplyPrinterChangeNotification-Funktion (winsplp.h)
Die PartialReplyPrinterChangeNotification-Funktion des Druckspoolers ermöglicht es einem Druckanbieter, die Datenbank der Druckeränderungen zu aktualisieren, die einem Benachrichtigungshandle zugeordnet sind.
Syntax
BOOL PartialReplyPrinterChangeNotification(
HANDLE hPrinter,
PPRINTER_NOTIFY_INFO_DATA pDataSrc
);
Parameter
hPrinter
Vom Anrufer bereitgestellter Handle. Dieser Handle muss zuvor als hNotify Eingabe an die FindFirstPrinterChangeNotification- funktion des Druckanbieters empfangen worden sein.
pDataSrc
Vom Aufrufer bereitgestellter Zeiger auf eine PRINTER_NOTIFY_INFO_DATA-Struktur (in der Microsoft Windows SDK-Dokumentation beschrieben). Kann NULL-sein. Weitere Informationen finden Sie im folgenden Abschnitt "Hinweise".
Rückgabewert
Wenn der Vorgang erfolgreich ist, gibt die Funktion TRUEzurück. Andernfalls gibt die Funktion FALSEzurück. Der Aufrufer kann einen Fehlercode abrufen, indem GetLastErroraufgerufen wird.
Bemerkungen
Für das angegebene Benachrichtigungshandle fügt die partielleReplyPrinterChangeNotification-Funktion Funktion 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 PartialReplyPrinterChangeNotification bewirkt nicht, dass der Spooler die Anwendung darüber 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 diesen Löschvorgang durch Freigeben aller Puffer aus, die pBuf- Member PRINTER_NOTIFY_INFO_DATA Strukturen des angegebenen Handles zugeordnet sind. 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 |
| Header- | winsplp.h (include Winsplp.h) |
| Library | Spoolss.lib |
| DLL- | Spoolss.dll |