NWPSJobGetNextJob(3nw)


NWPSJobGetNextJob -- retrieves next job name and owner for print job configuration

Synopsis

   #include <nwps_job.h> 
   or 
   #include <nwpsrv.h> 
   

NWCCODE NWAPI NWPSJobGetNextJob (NWPSListHandle handle, char NWFAR *dbOwner, char NWFAR *pJobName, WORD NWFAR *defaultPJ);

Description

The parameters are as follows:

handle
(IN) Specifies the value returned from NWPSJobGetFirstJob.

dbOwner
(IN/OUT) Points to the username of the owner of the database (optional). Its maximum length is MAX_DN_BYTES.

pJobName
(OUT) Points to the print job name found. Its maximum length is NWPS_JOB_NAME_SIZE.

defaultPJ
(OUT) Points to single-byte default job flag, defined as follows:
   NWPS_DOMINANT_DEFAULT_JOB     1 
   NWPS_CURRENT_DB_DEFAULT_JOB   2 
or any combination may be returned

Return values

0x0000
Successful

0x7771
End of Job Names

-1
General Error

other
Bindery or Directory Services Errors

Notices

dbOwner returns the directory object name or bindery user name of the owner of the database to be searched. You can set it to NULL if all relative databases are to be searched starting at the current user's database.

If the handle is zero, NWPSE_END_SCAN is returned, indicating the end of the list of job names.

Services

Print Server

References

NWPSJobGetFirstJob(3nw), NWPSJobEndNextJob(3nw), NWPSJobRead(3nw)
30 January 1998
© 1998 The Santa Cruz Operation, Inc. All rights reserved.