RouterFreePrinterNotifyInfo - NtDoc
Native API online documentation, based on the System Informer
(formerly Process Hacker) phnt
headers
// winsplp.h
BOOL RouterFreePrinterNotifyInfo(
[in, optional] PPRINTER_NOTIFY_INFO pInfo
);
View the official Windows Driver Kit DDI referenceNo description available.
The print spooler's RouterFreePrinterNotifyInfo function deallocates a specified PRINTER_NOTIFY_INFO structure and its associated PRINTER_NOTIFY_INFO_DATA structure array. (These structures are described in the Microsoft Windows SDK documentation.)
pInfo [in, optional]Caller-supplied pointer to a PRINTER_NOTIFY_INFO structure (described in the Windows SDK documentation).
If the operation succeeds, the function returns TRUE. Otherwise the function returns FALSE.
A print provider's RefreshPrinterChangeNotification function should call RouterFreePrinterNotifyInfo to deallocate structures previously allocated by RouterAllocPrinterNotifyInfo, but only if RefreshPrinterChangeNotification encounters an error. If RefreshPrinterChangeNotification succeeds, you should assume that the client application will deallocate the structures.
Besides deallocating the specified PRINTER_NOTIFY_INFO structure and its associated PRINTER_NOTIFY_INFO_DATA structure array, the function also deallocates buffer space pointed to by pBuf in any element of the PRINTER_NOTIFY_INFO_DATA structure array.
For additional information, see Supporting Printer Change Notifications.
RefreshPrinterChangeNotification