
Click above to get retro games delivered to your door ever month!
X-Hacker.org- Novlib 3.30 Online Reference - <b> qjbdescriptionget() / qjbdescriptionset()</b>
[<<Previous Entry] [^^Up^^] [Next Entry>>] [Menu] [About The Guide]
QJbDescriptionGet() / QJbDescriptionSet()
------------------------------------------------------------------------------
Purpose:
Get or set the queue job description.
Syntax:
lpszDesc = QJbDescriptionGet( dwQueueID, iJobNum )
lpszDesc = QJbDescriptionSet( dwQueueID, iJobNum, lpszNewDesc )
Parameters:
dwQueueID The print queue ID number.
iJobNum The print job number.
lpszNewDesc The new job description.
Returns:
A character string of length 49.
The CA-Clipper names for these functions are:
QJbDscGet() / QJbDscSet()
Description:
QJbDescriptionGet() returns a character string containing
the description of print job number iJobNum in the print queue specified by
ID number dwQueueID. Returns an empty string if an error occurs.
QJbDescriptionSet() sets the job description to lpszNewDesc and returns the
previous description if successful.
Example:
// To display the description of job number 244 in print queue PRINTQ_1:
dwCurrQ = QueIDGet( "PRINTQ_1" )
if ( dwCurrQ != NOVERRLONG )
lpszTextStr = QJbDescriptionGet( dwCurrQ, 244 )
if ( !empty(lpszTextStr) )
? "The description of job 244 is", lpszTextStr
endif
endif
// To change the description of job number 244 in print queue PRINTQ_1
// to "JOB 244":
dwCurrQ = QueIDGet( "PRINTQ_1" )
if ( dwCurrQ != NOVERRLONG )
lpszTextStr = QJbDescriptionSet( dwCurrQ, 244, "JOB 244" )
if ( !empty(lpszTextStr) )
? "The new description of job 244 is", lpszTextStr
endif
endif
Notes:
The print queue ID number is obtained using the QueIDGet() function
and print job numbers are obtained using the QueQJbList() function. To
change the job description, the requesting user must either own the
specified job or have queue operator rights.
See Also: QueIDGet() QueQJbList()
Online resources provided by: http://www.X-Hacker.org --- NG 2 HTML conversion by Dave Pearson