FindFirstPrinterChangeNotification function (winspool.h)

Warning

Starting with Windows 10, the APIs which support third-party print providers are deprecated. Microsoft does not recommend any investment into third-party print providers. Additionally, on Windows 8 and newer products where the v4 print driver model is available, third-party print providers may not create or manage queues which use v4 print drivers.

A print provider's FindFirstPrinterChangeNotification function informs the provider that an application has requested notification when a specified set of events occur on a specified print queue.

Syntax

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

Parameters

hPrinter

Caller-supplied printer handle, identifying the printer for which event notification is being requested. This handle must have been previously obtained from OpenPrinter.

fdwFilter

Defines the DWORD parameter fdwFilter.

fdwOptions

Not used.

pPrinterNotifyOptions

Caller-supplied pointer to a PRINTER_NOTIFY_OPTIONS structure (described in the Windows SDK documentation).

Return value

Returns the print driver handle.

Remarks

When the spooler calls a print provider's FindFirstPrinterChangeNotification function, pPrinterNotifyOptions identifies the types of information that the print provider should send to the spooler when one of the specified events occurs.

For a list of the types of notifications an application can request, and for a list of the types of information that can be used to describe an event, see the Windows SDK documentation's description of FindFirstPrinterChangeNotification. Types of events for which an application might request notification include adding or deleting a print job or form. Types of information an application might request include job or form parameters.

If the print provider does not request polling, the print provider must supply the types of information identified by pPrinterNotifyOptions, by calling PartialReplyPrinterChangeNotification or ReplyPrinterChangeNotification.

If the provider does request polling (that is, it sets PRINTER_NOTIFY_STATUS_POLL), it should not call ReplyPrinterChangeNotification. Instead, the spooler signals the application at regular intervals.

Both polled and nonpolled print provider must return the current state of all requested information types whenever its RefreshPrinterChangeNotification function is called.

For additional information, see Supporting Printer Change Notifications.

Requirements

Requirement Value
Target Platform Desktop
Header winspool.h (include Winspool.h)
Library WinSpool.lib
DLL WinSpool.drv

See also

ReplyPrinterChangeNotification

PartialReplyPrinterChangeNotification

RefreshPrinterChangeNotification