NWPSJobRead(3nw)
NWPSJobRead --
searches for print job record in PRINTCON database
Synopsis
#include <nwps_job.h>
or
#include <nwpsrv.h>
NWCCODE NWAPI NWPSJobRead
(WORD connType,
DWORD connID,
char NWFAR
dbOwner,
char NWFAR
pJobName,
NWPS_Job_Rec NWFAR
pJobRecord);
Description
The parameters are as follows:
- connType
-
(IN) Specifies either NWPS_BINDERY_SERVICE,
NWPS_BINDERY_SERVICE_PRE_40, or NWPS_DIRECTORY_SERVICE.
- connID
-
(IN) Specifies the connection or context identifier.
- dbOwner
-
(IN/OUT) Points to the user name of the owner of the database (optional).
- pJobName
-
(IN/OUT) Points to the name of the print job to read.
- pJobRecord
-
(OUT) Points to NWPS_Job_Rec where the print job record is stored.
Return values
- 0x0000
-
NWPSE_SUCCESSFUL
- 0x7770
-
NWPSE_BAD_VERSION
- 0x7773
-
NWPSE_ERROR_GETTING_DEFAULT
- 0x7774
-
NWPSE_ERROR_OPENING_DB
- 0x7775
-
NWPSE_ERROR_READING_DB
- 0x7776
-
NWPSE_ERROR_READING_RECORD
- 0x7779
-
NWPSE_INTERNAL_ERROR
- 0x777B
-
NWPSE_NO_DEFAULT_SPECIFIED
Notices
dbOwner is the user name of the owner of the database to be
searched, or it is NULL if all databases are to be searched
starting at the current user's database. If a NULL is used,
dbOwner returns the name of the job owner.
If dbOwner is NWPS_DBOWNER_PUBLIC, the public database
of the NetWare server or the database of the nearest organizational unit
on the directory is affected.
In NWPS_BINDERY_SERVICE or NWPS_BINDERY_SERVICE_PRE_40
mode, dbOwner is a user on the NetWare server.
(NWPS_DBOWNER_PUBLIC is not valid for
NWPS_BINDERY_SERVICE_PRE_40.)
In NWPS_DIRECTORY_SERVICE mode, dbOwner is a user or
an organizational unit in the directory.
Services
Print Server
References
NWPSJobWrite(3nw),
NWPSJobGetDefault(3nw),
NWCCOpenConnByName(3nw),
NWDSCreateContext(3nw)
30 January 1998
© 1998 The Santa Cruz Operation, Inc. All rights reserved.