FindFirstPrinterChangeNotification-Funktion (winspool.h)

Artikel
03/05/2024

Warnung

Ab Windows 10 sind die APIs, die Druckanbieter von Drittanbietern unterstützen, veraltet. Microsoft empfiehlt keine Investitionen in Druckdienstleister von Drittanbietern. Bei Windows 8 und neueren Produkten, bei denen das v4-Drucktreibermodell verfügbar ist, können Druckanbieter von Drittanbietern möglicherweise 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 angegebene Gruppe von Ereignissen in einer angegebenen Druckwarteschlange auftritt.

Syntax

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

Parameter

hPrinter

Vom Aufrufer bereitgestelltes Druckerhandle, das den Drucker identifiziert, für den eine Ereignisbenachrichtigung angefordert wird. Dieses Handle muss zuvor von OpenPrinter abgerufen worden sein.

fdwFilter

Definiert den DWORD-ParameterfdwFilter.

fdwOptions

Wird nicht verwendet.

pPrinterNotifyOptions

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

Rückgabewert

Gibt das Drucktreiberhandle zurück.

Hinweise

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 beschreibung von FindFirstPrinterChangeNotification in der Windows SDK Dokumentation. Zu den Arten von Ereignissen, für die eine Anwendung eine Benachrichtigung anfordern kann, gehören das Hinzufügen oder Löschen eines Druckauftrags oder Formulars. Zu den Informationstypen, die eine Anwendung anfordern kann, gehören Auftrags- oder Formularparameter.

Wenn der Druckanbieter keine Abrufe anfordert, muss der Druckanbieter die durch pPrinterNotifyOptions identifizierten Informationstypen bereitstellen, indem partialReplyPrinterChangeNotification oder ReplyPrinterChangeNotification aufgerufen wird.

Wenn der Anbieter Abrufe anfragt (d. h. er legt PRINTER_NOTIFY_STATUS_POLL fest), sollte er ReplyPrinterChangeNotification nicht aufrufen. Stattdessen signalisiert der Spooler die Anwendung in regelmäßigen Abständen.

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

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