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) );
- 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.
The function returns an error code.
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."
index, Tric_ReleaseStatusNotify, SMONID, Error Code