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.