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.