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.