FindFirstPrinterChangeNotification-Funktion (winspool.h)

Artikel
02/07/2025

Warnung

Ab Windows 10 sind die APIs, die Druckanbieter von Drittanbietern unterstützen, veraltet. Microsoft empfiehlt keine Investition in Druckanbieter von Drittanbietern. Darüber hinaus können Drittanbieter unter Windows 8 und neueren Produkten, bei denen das v4-Drucktreibermodell verfügbar ist, keine Warteschlangen erstellen oder verwalten, die v4-Drucktreiber verwenden.

Die FindFirstPrinterChangeNotification Funktion eines Druckanbieters informiert den Anbieter darüber, dass eine Anwendung eine Benachrichtigung angefordert hat, wenn eine bestimmte Gruppe von Ereignissen in einer angegebenen Druckwarteschlange auftritt.

Syntax

HANDLE FindFirstPrinterChangeNotification(
  HANDLE hPrinter,
  DWORD  fdwFilter,
  DWORD  fdwOptions,
  PVOID  pPrinterNotifyOptions
);

Parameter

hPrinter

Vom Anrufer bereitgestellter Druckerhandle, der den Drucker identifiziert, für den die Ereignisbenachrichtigung angefordert wird. Dieser Handle muss zuvor von OpenPrinterabgerufen worden sein.

fdwFilter

Definiert den DWORD Parameter fdwFilter-.

fdwOptions

Wird nicht verwendet.

pPrinterNotifyOptions

Vom Aufrufer bereitgestellter Zeiger auf eine PRINTER_NOTIFY_OPTIONS-Struktur (in der Windows SDK-Dokumentation beschrieben).

Rückgabewert

Gibt den Drucktreiberhandle zurück.

Bemerkungen

Wenn der Spooler die FindFirstPrinterChangeNotification-Funktion eines Druckanbieters aufruft, identifiziert pPrinterNotifyOptions die Informationstypen, die der Druckanbieter an den Spooler senden soll, wenn eines der angegebenen Ereignisse auftritt.

Eine Liste der Typen von Benachrichtigungen, die eine Anwendung anfordern kann, und eine Liste der Informationstypen, die zum Beschreiben eines Ereignisses verwendet werden können, finden Sie in der Windows SDK-Dokumentation zur Beschreibung FindFirstPrinterChangeNotification. Zu den Ereignistypen, für die eine Anwendung möglicherweise eine Benachrichtigung anfordern kann, gehören das Hinzufügen oder Löschen eines Druckauftrags oder Formulars. Arten von Informationen, die eine Anwendung anfordern kann, umfassen Auftrags- oder Formularparameter.

Wenn der Druckanbieter keine Abrufanforderung anfordert, muss der Druckanbieter die informationstypen bereitstellen, die von pPrinterNotifyOptionsidentifiziert werden, indem er PartialReplyPrinterChangeNotification oder ReplyPrinterChangeNotificationaufruft.

Wenn der Anbieter abruft (d. h., er legt PRINTER_NOTIFY_STATUS_POLL fest), sollte er nicht ReplyPrinterChangeNotificationaufrufen. Stattdessen signalisiert der Pooler die Anwendung in regelmäßigen Abständen.

Sowohl der abgefragte als auch der nichtpolierte Druckanbieter müssen den aktuellen Status aller angeforderten Informationstypen zurückgeben, wenn seine RefreshPrinterChangeNotification--Funktion aufgerufen wird.

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