NWPSComGetPrintJobStatus(3nw)


NWPSComGetPrintJobStatus -- retrieves print job status

Synopsis

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

NWCCODE NWAPI NWPSComGetPrintJobStatus (WORD spxID, WORD printerID, char NWFAR *nServerName, char NWFAR *queueName, WORD NWFAR *jobID, char NWFAR *jobDescription, WORD NWFAR *copiesRequested, DWORD NWFAR *printJobSize, WORD NWFAR *copiesDone, DWORD NWFAR *bytesDone, WORD NWFAR *formNumber, BYTE NWFAR *textFlag);

Description

The parameters are as follows:

spxID
(IN) Specifies the SPX connection to the print server.

printerID
(IN) Specifies the printer (0 to maximum number of printers).

nServerName
(OUT) Points to the name of the NetWare server.

queueName
(OUT) Points to the name of the queue the job came from.

jobID
(OUT) Points to the queue job number.

jobDescription
(OUT) Points to the job description from the queue jobheader.

copiesRequested
(OUT) Points to the number of copies to be printed.

printJobSize
(OUT) Points to the size of each copy requested.

copiesDone
(OUT) Points to the number of copies printed or buffered.

bytesDone
(OUT) Points to the number of bytes already printed in the currently printing copy.

formNumber
(OUT) Points to the number of the current form.

textFlag
(OUT) Points to a valud indicating whether to expand tabs: TRUE=(text) expand tabs; FALSE=(byte stream) do not expand tabs.

Return values

0x0000
NWPSE_SUCCESSFUL

0x00ED
NWPSE_CONNECTION_TERMINATED

0x0103
NWPSE_BINDERY_LOCKED

0x0301
NWPSE_NOT_ENOUGH_MEMORY

0x0302
NWPSE_NO_SUCH_PRINTER

0x0309
NWPSE_NO_JOB_ACTIVE

0x030C
NWPSE_DOWN

0x030E
NWPSE_NO_RIGHTS

Notices

printJobSize is the size of the print job in bytes, including a form feed, unless suppress form feed has been set.

copiesDone is the number of copies already printed, including a form feed, unless suppress form feed has been set.

NWPSComGetPrintJobStatus is for operators and users.

Services

Print Server

NCP calls

None

References

NWPSComAttachToPrintServer(3nw), NWPSComGetPrinterStatus(3nw), NWPSComLoginToPrintServer(3nw)
30 January 1998
© 1998 The Santa Cruz Operation, Inc. All rights reserved.