Tric_RequestStatusNotify

The Tric_RequestStatusNotify function is used to request the status monitor to send the printer status information. The status monitor sends the data from the printer by transmitting the WM_COPYDATA messages toward the preset window handle.

short WINAPI Tric_RequestStatusNotify(
 LPSTR  lpszPrinterName,  // a pointer to a string for a printer name that ends with NULL (IN)
 HWND  hWnd,              // a window handle that communicates the status information (IN)
 LPDWORD  lpdwSMonID     // a pointer to the buffer that stores SmonID (OUT)
);
  

Parameter

lpszPrinterName
a parameter to specify a pointer to a character string for printer friendly name. A string for printer friendly name ends with a NULL character.

hWnd
a parameter to specify a window handle of the application that receives the WM_COPYDATA messages. The status monitor sends the WM_COPYDATA messages toward this window handle.

lpdwSMonID
a parameter to specify a pointer to the buffer to store the status monitor identifier, SMONID.

Return Value

The function returns an error code.

Description

To obtain the printer status information from the status monitor, it is required to execute "Tric_RequestStatusNotify."
To cancel the request for the status information, "Tric_ReleaseStatusNotify" shall be executed.
The status information will be continuously sent until "Tric_RequestStatusNotify" is executed from another application or the request is cancelled with "Tric_ReleaseStatusNotify."

Reference

index, Tric_ReleaseStatusNotify, SMONID, Error Code
<strong>Back</strong>