windows_programming_notes.nbk: Home | Index | Next Page: WM_STYLECHANGED | Previous Page: WM_SIZING

 WM_SPOOLERSTATUS

The WM_SPOOLERSTATUS message is sent from Print Manager whenever a job is added to or removed from the Print Manager queue.

A window receives this message through its WindowProc function.

    LRESULT CALLBACK WindowProc(
     HWND hwnd,       // handle to window
     UINT uMsg,       // WM_SPOOLERSTATUS
     WPARAM wParam,   // job status
     LPARAM lParam    // number of jobs remaining
    );

Parameters

• wParam
Specifies the PR_JOBSTATUS flag.
• lParam
The low-order word specifies the number of jobs remaining in the Print Manager queue.

Return Values

An application should return zero if it processes this message.

Remarks

This message is for informational purposes only. This message is advisory and does not have guaranteed delivery semantics. Applications should not assume that they will receive a WM_SPOOLERSTATUS message for every change in spooler status.

Note The WM_SPOOLERSTATUS message is not supported after Windows XP. To be notified of changes to the print queue status in Windows NT 3.5 and later versions of Windows, you can use FindFirstPrinterChangeNotification and FindNextPrinterChangeNotification.

Requirements

• Windows NT/2000/XP/Vista: Included in Windows NT 3.1 and later.
• Windows 95/98/Me: Included in Windows 95 and later.
• Header: Declared in Winuser.h; include Windows.h.

windows_programming_notes.nbk: Home | Index | Next Page: WM_STYLECHANGED | Previous Page: WM_SIZING

Notebook exported on Monday, 7 July 2008, 18:56:50 PM Eastern Daylight Time