Skip to content

FindFirstPrinterChangeNotification.md

Latest commit

 

History

History
67 lines (45 loc) · 2.06 KB

FindFirstPrinterChangeNotification.md

File metadata and controls

67 lines (45 loc) · 2.06 KB

Home

Function name : FindFirstPrinterChangeNotification

Group: Printing and Print Spooler - Library: winspool.drv

Creates a change notification object and returns a handle to the object. You can then use this handle in a call to one of the wait functions to monitor changes to the printer or print server.

Code examples:

Using Change Notification Objects to monitor changes to the printer or print server

Declaration:

HANDLE FindFirstPrinterChangeNotification(
	HANDLE hPrinter,  // handle to printer
	DWORD fdwFlags,   // conditions to monitor
	DWORD fdwOptions, // reserved, must be zero
	LPVOID pPrinterNotifyOptions  // fields to monitor
);

FoxPro declaration:

DECLARE INTEGER FindFirstPrinterChangeNotification;
IN winspool.drv;
	INTEGER  hPrinter,;
	LONG     fdwFlags,;
	LONG     fdwOptions,;
	STRING @ pPrinterNotifyOptions

Parameters:

hPrinter [in] Handle to the printer or print server that you want to monitor.

fdwFlags [in] Specify the conditions that will cause the change notification object to enter a signaled state.

fdwOptions Reserved; must be zero.

pPrinterNotifyOptions [in] Pointer to a PRINTER_NOTIFY_OPTIONS structure.

Return value:

If the function succeeds, the return value is a handle to a change notification object associated with the specified printer or print server.

Comments:

To monitor a printer or print server, call the FindFirstPrinterChangeNotification function, then use the returned change notification object handle in a call to one of the wait functions, like WaitForSingleObject.

See also: FindNextPrinterChangeNotification, FindClosePrinterChangeNotification, OpenPrinter.