ReplyPrinterChangeNotification-Funktion (winsplp.h)

  • Artikel

Die ReplyPrinterChangeNotification-Funktion des Druckspoolers ermöglicht es einem Druckanbieter, die Datenbank des Spoolers mit Druckwarteschlangenereignissen zu aktualisieren, die einem Benachrichtigungshandle zugeordnet sind, und den Client darüber zu benachrichtigen, dass Druckwarteschlangenereignisse aufgetreten sind.

Syntax

BOOL ReplyPrinterChangeNotification(
                  HANDLE hPrinter,
                  DWORD  fdwChangeFlags,
  [out, optional] PDWORD pdwResult,
  [in, optional]  PVOID  pPrinterNotifyInfo
);

Parameter

hPrinter

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

fdwChangeFlags

Mindestens ein vom Aufrufer bereitgestelltes PRINTER_CHANGE_ Flags mit Präfix, die in der beschreibung von FindNextPrinterChangeNotification in der Microsoft Windows SDK-Dokumentation aufgeführt sind.

[out, optional] pdwResult

Optional. Wenn nicht NULL, empfängt er von Spooler bereitgestellte PRINTER_NOTIFY_INFO-Präfix-Flags, die die Ergebnisse der Aktualisierung der bereitgestellten Informationen angeben.

[in, optional] pPrinterNotifyInfo

Optional. Vom Aufrufer bereitgestellte Adresse einer PRINTER_NOTIFY_INFO-Struktur (in der Windows SDK-Dokumentation beschrieben). Kann NULL sein, wenn keine neuen Benachrichtigungsinformationen hinzugefügt werden.

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

Druckanbieter, die keine Abrufe unterstützen (siehe FindFirstPrinterChangeNotification), müssen den Spooler über das Auftreten von Ereignissen benachrichtigen, die durch die PRINTER_CHANGE_ Flags dargestellt werden, die von der FindFirstPrinterChangeNotification-Funktion des Anbieters empfangen werden. Wenn ein Ereignis auftritt, kann der Druckanbieter ReplyPrinterChangeNotification aufrufen, um den Spooler über das Ereignis zu informieren und dem Ereignis zugeordnete Informationen anzugeben. Der Spooler verfolgt diese Ereignisinformationen für jedes Benachrichtigungshandle nach und übermittelt die Informationen an eine Anwendung, wenn die Anwendung FindNextPrinterChangeNotification aufruft (in der Windows SDK-Dokumentation beschrieben).

Wenn ein Druckanbieter ReplyPrinterChangeNotification aufruft, muss er das aufgetretene Ereignis identifizieren, indem er ein Flag mit PRINTER_CHANGE_ Präfix in fwdFlags festlegt oder pPrinterNotifyInfo verwendet, um eine PRINTER_NOTIFY_INFO-Struktur zurückzugeben. (Verwenden Sie die Flags, die in der Beschreibung von FindNextPrinterChangeNotification in der Windows SDK Dokumentation aufgeführt sind, und nicht die Flags, die in der Windows SDK Dokumentation zu FindFirstPrinterChangeNotification aufgeführt sind.)

Der Aufruf von ReplyPrinterChangeNotification bewirkt, dass der Spooler der Clientanwendung signalisiert, dass ein Druckwarteschlangenereignis aufgetreten ist. Dies geschieht auch, wenn der Anbieter NULL für pPrinterNotifyInfo bereitstellt. Verwenden Sie PartialReplyPrinterChangeNotification, um den Datensatz der Druckwarteschlangenänderungen des Spoolers zu aktualisieren, ohne dass der Client benachrichtigt wird. Es ist üblich, PartialReplyPrinterChangeNotification mehrmals aufzurufen, um die Datenbank des Spoolers zu aktualisieren, und dann ReplyPrinterChangeNotification aufzurufen, um den Client zu benachrichtigen, dass Änderungen aufgetreten sind.

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

Weitere Informationen

FindFirstPrinterChangeNotification

PartialReplyPrinterChangeNotification